para desenvolvedores
Criar conta
DocsQuickstart

Quickstart

Da conta criada à primeira leitura do Instagram. Agentes entram pelo navegador; backends usam uma chave do console.

Antes de começar

  • Conta Keymatic com o Developers ativado.
  • Plano com API Keymatic e MCP em dia.
  • Instagram profissional conectado em Contas.

Vários Instagrams na mesma instalação

Quando habilitado no ambiente, o consentimento OAuth permite selecionar várias contas atuais. Cada Instagram continua usando sua licença; conectar outro perfil depois não amplia essa autorização.

Liste as contas autorizadas e escolha o ID de cada operação. Uma sessão originalmente múltipla continua exigindo o alvo mesmo depois de revogar uma das contas. Chaves manuais continuam vinculadas a um Instagram.

# Token OAuth da sessão; primeiro descubra os IDs autorizados.
curl "https://ig.keymatic.com.br/api/instagram/contas" \
  -H "Authorization: Bearer $KEYMATIC_OAUTH_TOKEN"

# Escolha explicitamente um ID retornado acima.
curl "https://ig.keymatic.com.br/api/instagram/perfil" \
  -H "Authorization: Bearer $KEYMATIC_OAUTH_TOKEN" \
  -H "X-Keymatic-Conta-Id: <conta_id-escolhido>"

  1. Adicione o servidor ao seu cliente

    Instalar é só registrar a URL. Não há pacote, extensão local nem token da Meta.

    Servidorhttps://ig.keymatic.com.br/api/mcp

    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

    JSON: mescle no arquivo existente, sem apagar outros servidores (Cursor em .cursor/mcp.json, VS Code em .vscode/mcp.json, Gemini CLI em .gemini/settings.json).

  2. Entre pelo navegador

    O cliente abre a página de consentimento da Keymatic (OAuth 2.1 com PKCE). Entre com a sua conta, escolha o Instagram e confira as permissões antes de autorizar.

    • 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.
    • Codex: O segundo comando abre o navegador. Amplie --scopes só com as permissões de que precisa.
    • Cursor: Abra as integrações MCP do Cursor e conclua a autenticação. Confira as permissões no consentimento.
    • VS Code: Ou use MCP: Add Server → HTTP com a mesma URL. O VS Code pede o login ao iniciar o servidor.
    • Gemini CLI: Na sessão do Gemini CLI, rode /mcp auth keymatic.

  3. Confirme a conexão

    Peça ao agente: “Use apenas consultar_uso e obter_perfil; informe o Instagram autorizado e as permissões disponíveis”. Leitura não publica nem responde nada.