Documentação para desenvolvedores

MCP

Conecte Claude, Codex e outros clientes MCP às suas notas do Alt.

O Alt oferece um servidor MCP (Model Context Protocol) hospedado. Clientes com suporte a OAuth podem entrar pelo navegador; chaves de API continuam disponíveis como alternativa. Os dois métodos aplicam os mesmos scopes somente leitura e limites de workspace.

Comece por aqui

Execute o assistente de configuração interativo — ele salva a chave de API, conecta o MCP e pode passar o trabalho ao seu agente:

npx

npx altalt --mcp-only

1. Conecte com OAuth (recomendado)

Adicione o endpoint sem cabeçalhos. Seu cliente descobre o servidor de autorização do Alt, registra-se e abre a tela de consentimento no navegador.

O Alt oferece Dynamic Client Registration e PKCE, então clientes compatíveis configuram o OAuth automaticamente.
Revise no navegador os scopes somente leitura e o workspace solicitados antes de aprovar o acesso.
O OAuth está disponível atualmente apenas para administradores do Alt. Se uma conexão OAuth antiga do Alt deixar de autenticar após esta atualização, remova-a do cliente e adicione-a novamente uma vez.

2. Conecte seu cliente

Use a configuração apenas com URL para OAuth. Não é necessário OAuth client ID nem secret; use uma chave de API somente se o cliente não conseguir concluir o OAuth.

MCP URL

https://mcp.altalt.io/mcp

Claude / Claude Desktop / Cowork

Abra Customize → Connectors → Add custom connector, informe o endpoint acima, deixe OAuth client ID e secret vazios e selecione Connect.

Claude Code

shell

claude mcp add --transport http alt https://mcp.altalt.io/mcp

Depois de adicionar o servidor, abra /mcp no Claude Code, selecione Alt e conclua a autenticação no navegador.

Codex CLI

shell

codex mcp add alt --url https://mcp.altalt.io/mcp
codex mcp login alt

config.toml

# ~/.codex/config.toml
[mcp_servers.alt]
url = "https://mcp.altalt.io/mcp"

Adicionar o servidor normalmente conclui a autenticação no navegador. Se ela não iniciar, execute codex mcp login alt.

Cursor

Adicionar ao Cursor

Instalação em um clique apenas com a URL. Nas configurações MCP do Cursor, selecione Connect ou Needs authentication e aprove o consentimento no navegador.

Outros clientes e alternativa com chave de API

Comece com a configuração OAuth apenas com URL. Se o cliente não oferecer suporte a MCP OAuth, use a configuração com chave de API Bearer.

OAuth

{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp"
    }
  }
}

Chave de API

{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp",
      "headers": { "Authorization": "Bearer alt_live_..." }
    }
  }
}

Chaves de API continuam disponíveis para automação e clientes antigos. Crie uma no console da conta, conceda apenas os scopes necessários, não a deixe em configurações compartilhadas e consulte Segurança para gerenciá-la.

3. Ferramentas

Quatro ferramentas somente leitura, espelhando a API REST e aplicando os mesmos scopes.

list_notes — Lista as notas visíveis para a chave, com paginação por cursor e filtro updated_after (notes:read).
get_note — Busca os metadados de uma nota: título, prontidão de transcrição/resumo, timestamps (notes:read).
get_note_transcript — Busca a transcrição completa em segmentos com tempo e rótulos de falante (transcripts:read).
get_note_summary — Busca o resumo de IA em Markdown (summaries:read).

As notas aparecem quando uma gravação termina ou um resumo é gerado — notas apenas de memo não são exportadas. Antes de o conteúdo ficar pronto, as ferramentas retornam transcript_not_ready / summary_not_ready, para que os agentes tentem novamente depois.