Servidor MCP + Agent Skill · código aberto (MIT)

Servidor MCP do Instagram: deixe o Claude configurar suas automações de comentário para DM

O kit para agentes do CommentKeyword dá ao Claude, ao Cursor e a outros clientes MCP as ferramentas para criar, redirecionar e pausar automações por palavra-chave no Instagram. Quando o Claude edita um Reel que termina com "Comente GUIA", ele pode deixar essa DM pronta para o seu próximo post antes de você publicar.

Plugin do Claude CodeClaude DesktopCursor, Windsurf e CodexAgent Skill para ReelsEm todos os planos, inclusive o Free
Exemplo no Claude Code

Você:Edite isto como um Reel. CTA: comente GUIA para receber o checklist grátis.

Claude:Reel editado. Adicionei um texto "Comente GUIA 👇" dentro da área segura e coloquei o CTA na primeira linha da legenda. Pronto para preparar a DM:

  • Palavra-chave: GUIA (palavra inteira)
  • Posts: seu próximo post ou reel
  • DM: "Aqui está o checklist, {{namefirst}} 👉 https://…"
  • Resposta pública: "Enviado! Confira suas DMs 📩"

Posso criar?

Você:Sim

create_keyword · target: next_post

Claude:Pronto. GUIA está esperando o seu próximo post. Publique o Reel e depois comente GUIA de outra conta para testar.

O que o seu agente de IA pode fazer com ele

O servidor MCP transforma a API do CommentKeyword em ferramentas que o seu agente pode usar. Você descreve a campanha; o agente configura e mostra o resultado.

Configure automações pelo chat

Peça a palavra-chave, a DM, variações e uma resposta pública com suas próprias palavras. O agente verifica se a palavra-chave já existe e depois cria a automação.

Prepare a DM antes de publicar

Com target: next_post você não precisa do ID do post. A automação se vincula sozinha ao próximo post ou reel que a conta publicar.

Passe a conversa para um agente de IA

Nos planos pagos, o agente pode vincular um dos seus agentes de IA ativos com aiAgentId, para que a conversa continue quando a pessoa responder à DM.

Para edição de vídeo com o Claude

Quando o Claude edita o seu Reel, a DM fica pronta antes de você postar

A Agent Skill comment-to-dm-cta entra em ação quando o Claude escreve o roteiro, edita ou legenda um vídeo curto cujo CTA pede para comentar uma palavra. Ela segue sempre os mesmos passos:

  1. 1Encontra o CTA no roteiro, na transcrição, nos textos na tela e na legenda. Se o vídeo promete um material mas não pede um comentário, sugere um CTA.
  2. 2Escolhe uma palavra-chave que não dispare por engano: uma única palavra marcante, não algo que as pessoas escrevem de qualquer jeito, como SIM ou UAU.
  3. 3Deixa o CTA consistente: falado na narração, mostrado como texto dentro da área segura dos Reels e escrito na primeira linha da legenda.
  4. 4Escreve a DM com o link prometido, além de variações de texto e uma resposta pública opcionais.
  5. 5Mostra um resumo e, só depois que você confirmar, cria a automação para o seu próximo post ou reel.

Usa o claude-code-video-toolkit? O complemento /comment-dm lê o CTA do seu projeto e prepara a DM antes de você publicar.

Instalação

Primeiro crie um token de API no CommentKeyword, em Configurações → API. Dê a ele keywords:read, keywords:write e agents:read. Adicione keywords:delete só se quiser que o agente possa excluir automações.

Instalar no Claude Code

O plugin instala a skill e o servidor MCP. O Claude Code pede o token de API quando você ativa o plugin e o guarda no chaveiro do sistema. Se quiser só o servidor MCP, use claude mcp add e substitua YOUR_TOKEN pelo seu token.

Plugin: servidor MCP + skill

/plugin marketplace add commentkeyword/agent-toolkit
/plugin install commentkeyword@commentkeyword

Só o servidor MCP

claude mcp add --transport stdio --env COMMENTKEYWORD_API_TOKEN=YOUR_TOKEN commentkeyword -- npx -y github:commentkeyword/agent-toolkit#v0.2.0

Instalar no Claude Desktop

Abra Settings → Developer → Edit Config, adicione o servidor ao claude_desktop_config.json, substitua YOUR_TOKEN pelo seu token e reinicie o Claude Desktop.

claude_desktop_config.json

{
  "mcpServers": {
    "commentkeyword": {
      "command": "npx",
      "args": ["-y", "github:commentkeyword/agent-toolkit#v0.2.0"],
      "env": { "COMMENTKEYWORD_API_TOKEN": "YOUR_TOKEN" }
    }
  }
}

Instalar no Cursor

Adicione o servidor ao ~/.cursor/mcp.json para usá-lo em todos os projetos, ou ao .cursor/mcp.json de um projeto só. Substitua YOUR_TOKEN pelo seu token.

mcp.json

{
  "mcpServers": {
    "commentkeyword": {
      "command": "npx",
      "args": ["-y", "github:commentkeyword/agent-toolkit#v0.2.0"],
      "env": { "COMMENTKEYWORD_API_TOKEN": "YOUR_TOKEN" }
    }
  }
}

Instalar no Windsurf

No painel do Cascade, abra as configurações de MCP e depois o arquivo de configuração MCP. Adicione a mesma entrada mcpServers e substitua YOUR_TOKEN pelo seu token.

mcp_config.json

{
  "mcpServers": {
    "commentkeyword": {
      "command": "npx",
      "args": ["-y", "github:commentkeyword/agent-toolkit#v0.2.0"],
      "env": { "COMMENTKEYWORD_API_TOKEN": "YOUR_TOKEN" }
    }
  }
}

Instalar no Codex

Adicione o servidor com a CLI do Codex, ou cole a tabela no ~/.codex/config.toml (ou no .codex/config.toml de um projeto confiável). Substitua YOUR_TOKEN pelo seu token.

CLI do Codex

codex mcp add commentkeyword --env COMMENTKEYWORD_API_TOKEN=YOUR_TOKEN -- npx -y github:commentkeyword/agent-toolkit#v0.2.0

~/.codex/config.toml

[mcp_servers.commentkeyword]
command = "npx"
args = ["-y", "github:commentkeyword/agent-toolkit#v0.2.0"]

[mcp_servers.commentkeyword.env]
COMMENTKEYWORD_API_TOKEN = "YOUR_TOKEN"

claude.ai e ChatGPT

Esses aplicativos só se conectam a servidores MCP remotos por URL. Hoje o servidor do CommentKeyword roda localmente, então use um dos aplicativos acima; uma versão remota está prevista. Se você usa o ChatGPT, o Codex aceita o mesmo servidor, e você entra nele com sua conta do ChatGPT. No claude.ai você ainda pode enviar a Agent Skill, como explicado abaixo.

O servidor roda no seu computador via npx, então precisa do Node.js 18 ou mais recente.

Só quer a skill? Baixe a pasta skills/comment-to-dm-cta do repositório, compacte em um zip e envie no Claude, em Customize → Skills. Sem o servidor MCP ela continua planejando o CTA e a DM.

Ferramentas MCP

Cada ferramenta chama a API pública do CommentKeyword com o seu token, então o agente só pode fazer o que as permissões do token permitem.

FerramentaO que fazPermissão
create_keywordCria uma automação. target é next_post, all_posts ou specific_posts. Também aceita variações da DM, respostas públicas opcionais, rastreamento de links e um agente de IA opcional.keywords:write
update_keywordAltera qualquer campo. Prepare de novo para o próximo upload com target: next_post ou pause com isActive: false.keywords:write
list_keywordsLista as automações, com busca opcional, para o agente identificar uma palavra-chave que já existe.keywords:read
get_keywordMostra uma automação, incluindo se o próximo post já foi capturado (nextPostStatus).keywords:read
delete_keywordExclui uma automação. Se houver um agente de IA vinculado, primeiro retorna um resumo do impacto para você confirmar.keywords:delete
list_agentsLista os agentes de IA do workspace, para vincular um agente ativo com aiAgentId.agents:read
Segurança

Ele pergunta antes de mandar mensagem para alguém

  • Toda automação envia mensagens para pessoas reais. A skill e as descrições das ferramentas orientam o agente a confirmar com você a palavra-chave, a DM e os posts antes de criar ou ativar qualquer coisa.
  • Cada token funciona para um único workspace e pode ser revogado a qualquer momento em Configurações → API.
  • Os tokens têm permissões limitadas. Um token só com keywords:read pode ver suas automações, mas não alterá-las.
  • Excluir uma palavra-chave com um agente de IA vinculado exige uma segunda confirmação explícita.
  • As DMs são enviadas pela API oficial do Instagram da Meta, com as mesmas regras das automações que você cria no painel.

Incluído em todos os planos

A API e o servidor MCP estão incluídos em todos os planos, inclusive no Free. Os limites normais do seu plano continuam valendo: o Free inclui 300 DMs automáticas por mês e 3 palavras-chave ativas. Agentes de IA que continuam a conversa depois da primeira DM estão disponíveis nos planos pagos.

Perguntas frequentes

O que é o servidor MCP do CommentKeyword?

Um servidor Model Context Protocol de código aberto (MIT) que transforma a API do CommentKeyword em ferramentas que um agente de IA pode usar: criar, atualizar, listar, consultar e excluir automações por palavra-chave, e listar agentes de IA. O seu agente pode configurar automações de comentário para DM no Instagram sem escrever requisições HTTP.

Funciona com ChatGPT, Cursor ou outras ferramentas de IA?

Funciona com clientes MCP que conseguem iniciar um servidor local, como Claude Code, Claude Desktop, Cursor, Windsurf e Codex, em que você pode entrar com uma conta do ChatGPT. O app do ChatGPT e outras ferramentas que só se conectam a servidores MCP remotos por URL ainda não conseguem executá-lo; uma versão remota está prevista, e elas podem chamar a API REST diretamente. A Agent Skill é uma pasta SKILL.md padrão, então outros agentes que leem Agent Skills também podem usá-la.

Usa OAuth?

Por enquanto, não. Usa um token de acesso pessoal que você cria em Configurações → API e informa como COMMENTKEYWORD_API_TOKEN. O plugin do Claude Code guarda o token no chaveiro do sistema. Você pode revogar um token a qualquer momento.

O que eu preciso no Instagram?

Uma conta profissional do Instagram (empresa ou criador de conteúdo) conectada ao CommentKeyword. O CommentKeyword envia as DMs pela API oficial do Instagram da Meta. O agente nunca faz login no Instagram.

O agente pode começar a enviar DMs sem me perguntar?

A skill e as descrições das ferramentas orientam o agente a mostrar a palavra-chave, a DM e os posts, e a esperar o seu OK antes de criar ou ativar qualquer coisa. Se você só quer que ele consulte, use um token apenas com permissões de leitura. Depois que você confirma, a automação funciona como uma criada no painel: só recebe a DM quem comenta a palavra-chave.

Preciso do ID do post?

Não. Com o destino next_post, a automação se vincula sozinha ao próximo post ou reel que a conta publicar. Esse é o caso mais comum enquanto o vídeo ainda está sendo editado. Você também pode escolher todos os posts ou posts específicos pelo ID de mídia do Instagram.

Tem custo adicional?

Não. A API e o servidor MCP estão incluídos em todos os planos, inclusive no Free. As DMs automáticas contam para o limite mensal do seu plano normalmente.

Existe um MCP oficial do Instagram?

Não. Em outubro de 2026, a Meta oferece um servidor MCP oficial para anúncios, mas não para posts, comentários ou DMs orgânicos do Instagram; por isso, todo servidor MCP do Instagram é de terceiros. Este funciona pelo CommentKeyword, que usa a API oficial do Instagram da Meta e nunca a sua senha. Veja o comparativo de servidores MCP do Instagram (em inglês).

Existe um servidor MCP do ManyChat?

Oficial, não, até outubro de 2026. A API do ManyChat não consegue criar automações de comentários, então os servidores MCP de terceiros para o ManyChat também não conseguem. O ManyChat tem servidor MCP?

Deixe o seu agente preparar a DM e publique

Crie uma conta gratuita no CommentKeyword, conecte sua conta profissional do Instagram, gere um token de API e instale o kit.

Começando agora? Veja o que o Claude consegue (e não consegue) fazer com o InstagramPrefere HTTP direto? Veja a API de automação do Instagram