$ claude mcp add --transport http keymatic https://ig.keymatic.com.br/api/mcp
Servidor MCP keymatic adicionado (HTTP)
$ claude
> /mcp → keymatic → autenticar
Abrindo o navegador para autorizar…
✓ Conectado a @suaconta
$ claude mcp add --transport http keymatic https://ig.keymatic.com.br/api/mcpServidor MCP keymatic adicionado (HTTP)$ claude> /mcp → keymatic → autenticarAbrindo o navegador para autorizar…✓ Conectado a @suaconta
Funciona com
Claude Code
Codex
Cursor
VS Code
Gemini CLI
qualquer cliente MCP
#produto
O que a sua integração faz no Instagram
REST e MCP chamam as mesmas operações, na mesma fila e com as mesmas franquias. Você escolhe a
interface; o comportamento é um só.
Publicar
Foto, Reels, carrossel e stories, com legenda.
POST /publicacoes
Agendar
Até 30 dias à frente. Cancele enquanto a operação não saiu.
executar_em
Insights
Métricas do perfil e de cada publicação.
GET /insights
Comentários
Leia por publicação e responda em nome da conta.
POST /comentarios/{id}/respostas
Moderação
Oculte comentários sem sair do seu produto.
POST /comentarios/{id}/ocultacao
Direct
Leia conversas e responda dentro da janela de 24 h aberta pela pessoa.
GET /conversas
Automações
Regras de resposta automática gerenciadas pela API REST.
POST /automacoes
Mídia
Importe imagem até 12 MiB e MP4 até 100 MB para publicar.
POST /midias/importacoes
Operações
Escritas idempotentes, com estado consultável do início ao fim.
GET /operacoes/{id}
Publicação e insights dependem das permissões que a Meta concede ao aplicativo. A documentação marca cada rota.
#como-funciona
Do cadastro à primeira chamada em três passos
01
Crie sua conta
Cadastro grátis no Keymatic Developers. O console abre na hora.
02
Conecte o Instagram
Pelo login oficial da Meta. Você escolhe a conta profissional e as permissões.
03
Instale ou integre
Adicione o MCP ao seu cliente com login no navegador, ou crie uma chave para o seu backend.
Agentes, pelo MCP
Login no navegador. Nenhuma chave no arquivo de configuração.
Instalação do MCP por cliente
Claude Code
claude mcp add --transport http keymatic https://ig.keymatic.com.br/api/mcp
# depois, dentro do Claude Code:
/mcp # escolha keymatic e autentique no navegador
Codex
codex mcp add keymatic --url https://ig.keymatic.com.br/api/mcp
codex mcp login keymatic # abre o navegador para autorizar
Seus clientes conectam o próprio Instagram numa página hospedada pela Keymatic, sem criar conta
na Keymatic. Você recebe uma chave filha, limitada às permissões que o cliente aprovou.
km_proj_… gerencia só conexões. Não lê nem escreve dados do Instagram.
URLs de retorno exatas, cadastradas no projeto. Até cinco por projeto.
Revogar a concessão desliga as chaves filhas no REST, no MCP e na fila.
01seu appcria uma sessão com a chave do projeto
02keymaticpágina hospedada com o login oficial da Meta
03seu clienteescolhe o Instagram e as permissões
04seu apprecebe o code na URL de retorno e troca por uma chave filha
Criar sessão de conexão
Sessão hospedada
curl -X POST "$KEYMATIC_URL/api/instagram/conexoes/sessoes" \
-H "Authorization: Bearer $KEYMATIC_PROJECT_KEY" \
-H "Content-Type: application/json" \
-d '{
"url_retorno": "https://app.seucrm.com/keymatic/retorno",
"state": "cliente-4821",
"permissoes": ["ler", "mensagens", "responder"]
}'
# 201 → redirecione o navegador do cliente para "url"
#seguranca
Chaves que fazem só o que você deixou
CRM produçãoativa
km_api_••••••••••••7f3a
conta
@suaconta
expira
em 90 dias
limite
60 req/min
ler
mensagens
responder
moderar
publicar
Exemplo ilustrativo
Escopo mínimo
Cada chave carrega só as permissões que você marcou: ler, mensagens, responder, moderar ou publicar.
Uma conta por chave
A chave fica presa a um Instagram. Não existe conta_id para trocar no caminho.
Mostrada uma vez
O segredo aparece só na criação. Depois o console mostra apenas o prefixo.
Prazo e revogação
Validade de 1 a 365 dias. Revogar vale na hora, no REST e no MCP.
Token da Meta fica aqui
O token da Meta é guardado cifrado e nunca sai da Keymatic. Você só lida com chaves Keymatic.
Isolamento por tenant
Dados de cada conta ficam separados no banco. Objeto de outro tenant responde 404.
#precos
Um preço por Instagram conectado
Criar conta e explorar o console é grátis. A licença entra quando você liga a API ou o MCP numa conta.
Instagram API & MCP
R$119/mês por conta Instagram
Licença mensal. REST e MCP na mesma licença: um segundo protocolo ou uma nova chave não cobram de novo.
Franquias somadas entre as licenças: três contas viram um só saldo de 30.000 operações.
Consultar uso, estado de operação e cancelar não consome franquia.
Os limites da Meta continuam valendo, com ou sem franquia sobrando.
#faq
Perguntas frequentes
Não achou aqui? A documentação cobre autenticação, limites e erros rota por rota.
Criar conta custa alguma coisa?
Não. A conta e o console são grátis. Para chamar a API ou o MCP em nome de um Instagram, essa conta precisa de uma licença de R$ 119 por mês.
Preciso criar um app na Meta?
Não. O Instagram é conectado pelo login oficial da Meta no aplicativo da Keymatic. Algumas capacidades, como publicação e insights, dependem das permissões que a Meta concede a esse aplicativo; a documentação marca cada uma.
Quando usar REST e quando usar MCP?
REST é para o backend do seu produto: chamadas determinísticas com chave de servidor. MCP é para agentes como Claude Code, Codex e Cursor. Os dois usam o mesmo motor, a mesma licença e as mesmas franquias.
Posso mandar DM para qualquer pessoa?
Não. As regras da Meta valem: a resposta só sai para quem escreveu para a conta, dentro de 24 horas e sem opt-out. A Keymatic confere tudo de novo antes do envio.
O que acontece se uma publicação falhar no meio?
Toda escrita é uma operação com Idempotency-Key. Repetir a mesma chave com o mesmo corpo devolve a mesma operação, sem publicar duas vezes. Se o resultado ficar incerto, consulte o estado antes de tentar de novo.
E o WhatsApp?
Ainda não existe API de WhatsApp para desenvolvedores. Está nos planos; o Developers oferece integração com Instagram hoje.