Clientes MCP

Instalar é adicionar a URL do servidor ao cliente. Não há pacote, extensão local, npx nem token da Meta. O login acontece no navegador.

Servidor

Transporte HTTP em /api/mcp no mesmo host destas docs, com JSON-RPC por POST. Revisões do protocolo implementadas: 2025-03-26, 2025-06-18 e 2025-11-25. Clientes só stdio ou SSE legado não têm instalação direta nesta versão.

Os exemplos fixam leitura (instagram:read). Para escrever, amplie só os scopes necessários e refaça o consentimento. Mescle os JSON no arquivo existente, sem apagar outros servidores.

Claude Code

O segundo comando abre o consentimento da Keymatic. O exemplo pede somente leitura; amplie oauth.scopes e autorize novamente para outras ações. Dentro do Claude Code, /mcp também permite autenticar keymatic.

Documentação do Claude Code

Claude Code

claude mcp add-json keymatic '{"type":"http","url":"https://ig.keymatic.com.br/api/mcp","oauth":{"scopes":"instagram:read"}}' --scope local
claude mcp login keymatic

Codex

O segundo comando abre o navegador. Amplie --scopes só com as permissões de que precisa.

Documentação do Codex

Codex

codex mcp add keymatic --url https://ig.keymatic.com.br/api/mcp
codex mcp login keymatic --scopes instagram:read --oauth-client-registration dcr

Cursor

Configuração em .cursor/mcp.json.

Abra as integrações MCP do Cursor e conclua a autenticação. Confira as permissões no consentimento.

Documentação do Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "keymatic": {
      "url": "https://ig.keymatic.com.br/api/mcp"
    }
  }
}

VS Code

Configuração em .vscode/mcp.json.

Ou use MCP: Add Server → HTTP com a mesma URL. O VS Code pede o login ao iniciar o servidor.

Documentação do VS Code

.vscode/mcp.json

{
  "servers": {
    "keymatic": {
      "type": "http",
      "url": "https://ig.keymatic.com.br/api/mcp"
    }
  }
}

Gemini CLI

Configuração em .gemini/settings.json.

Na sessão do Gemini CLI, rode /mcp auth keymatic.

Documentação do Gemini CLI

.gemini/settings.json

{
  "mcpServers": {
    "keymatic": {
      "httpUrl": "https://ig.keymatic.com.br/api/mcp",
      "trust": false,
      "oauth": {
        "enabled": true,
        "issuer": "https://ig.keymatic.com.br/api/mcp/oauth",
        "authorizationResponseIssParameterSupported": false,
        "scopes": [
          "instagram:read"
        ]
      }
    }
  }
}

Cliente sem OAuth

Se o cliente aceita Bearer mas não conclui OAuth, crie uma credencial em Chaves da API Keymatic com a conta, as permissões e a validade mínimas. No Codex, use --bearer-token-env-var KEYMATIC_MCP_TOKEN e carregue a variável a partir do gerenciador de segredos.

Não coloque a credencial em argumento de shell, arquivo compartilhado, prompt, print ou commit. O OAuth evita essa transferência manual.

Confirmar a instalação

Peça ao agente: “Use listar_contas e mostre os Instagrams autorizados. Aguarde minha escolha; depois use consultar_uso e obter_perfil com o conta_id escolhido”. Uma chamada escolhe uma conta; selecionar várias no consentimento não publica nem responde em lote.

O que já foi testado

Cliente	Estado conferido em 06/11/2026
SDK oficial MCP Python 1.30.0	Initialize, ferramentas e perfil real por Bearer testados em DEV
Keymatic CLI local 0.1.0	Login real pelo Safari, PKCE, perfil e revogação remota testados
Codex CLI 0.166.0	OAuth, descoberta, listar_contas e perfil no runtime nativo; revogação e logout testados em DEV
Claude Code 2.1.318	OAuth e conexão nativos, revogação e logout testados; chamada de ferramenta por este cliente não exercitada
Cursor, Gemini CLI, VS Code	Receitas da documentação oficial; teste ponta a ponta pendente