Instant Reply MCP Server

Conecte assistentes de IA a conversas do Instagram, WhatsApp e Messenger, contatos, modelos do WhatsApp, jornadas e diagnósticos de entrega através do Instant Reply.

Ver em instantreply.coExperimente este MCPPatrocinado

Documentação

Servidor MCP para sua caixa de entrada yourAI.

Claude Code, Cursor, Windsurf, Zed e Claude Desktop obtêm acesso direto às suas DMs do Instagram, conversas do WhatsApp e caixa de entrada do Messenger — lendo conversas, rascunhando respostas, gerenciando o ciclo de vida de templates e depurando entregas de jornadas por meio de 34 ferramentas, 11 prompts e dois recursos. Execute um único comando npx e peça ao seu agente para conectar: ele se emparelha por meio de um link de configuração assinado, a mesma concessão de autorização de dispositivo que o gh auth login usa, então não é necessário visitar o painel nem copiar chave de API primeiro.

config do mcp · escolha um

{
  "mcpServers": {
    "instantreply": {
      "command": "npx",
      "args": [
        "-y",
        "@instantreply.co/mcp"
      ]
    }
  }
}

Prefere não instalar? Claude.ai: Configurações → Conectores → Adicionar conector personalizado → cole https://api.instantreply.co/mcp → faça login. ChatGPT: adicione como conector com o modo desenvolvedor ativado. O teste gratuito dá acesso total. Ainda não tem chave? Adicione o bloco sem chave, reinicie o cliente e peça para conectar o InstantReply. Ele entrega um código e um link. Já emparelhado? Use os comandos de barra como /audit_template_cost ou /utility_rewrite_loop.

Instalar · sem chave

Qualquer agente que possa executar npx consegue fazer isso.

Sem visita ao painel, sem chave copiada. O servidor solicita um código de dispositivo da mesma forma que o gh auth login ou um app de smart TV faz (RFC 8628, concessão de autorização de dispositivo), mostra um link e captura a chave no momento em que você aprova em um navegador.

01
Adicione o bloco
Coloque isso na config MCP do seu cliente. Sem chave, sem instalação global.
```
"instantreply": {
  "command": "npx",
  "args": ["-y", "@instantreply.co/mcp"]
}
```
Copiar

Peça para conectar

Seu agente chama start_setup e recebe um código e um link. Abra o link, cadastre-se ou faça login (captcha e consentimento se aplicam, igual ao site) e aprove.

{
  "instructions": "Tell the user to open this link and approve: https://www.instantreply.co/pair/ABCD-2345",
  "code": "ABCD-2345",
  "link": "https://www.instantreply.co/pair/ABCD-2345",
  "expires_in_seconds": 600,
  "device_code": "kx9F2q... (opaque, single use)",
  "poll_interval_seconds": 5,
  "next_step": "Call check_setup with this device_code once approved."
}

Copiar

03
Reconecte e depois peça
check_setup confirma a aprovação e armazena a chave em ~/.instantreply/config.json. Reinicie o cliente uma vez; toda execução de npx depois disso pula a configuração.
```
"Find unanswered DMs from today,
 draft a reply for each,
 send only after I confirm."
```
Copiar

O link de configuração expira em 10 minutos e o código é de uso único. Prefere gerenciar uma chave você mesmo, para CI, Docker ou uma máquina compartilhada? Gere uma em Configurações → Chaves de API e defina INSTANTREPLY_API_KEY em vez disso. Leia a especificação em RFC 8628.

Ferramentas · 34

Anotadas para agentes seguros.

Toda ferramenta anuncia readOnlyHint e destructiveHint. Agentes compatíveis pedem antes de escrever.

get_connection_guide como conectar cada canal, sem chave necessárialeitura
list_conversations listar conversas da caixa de entradaleitura
get_conversation buscar uma conversa com a última mensagemleitura
list_messages paginar mensagens em uma conversaleitura
send_message entregar uma resposta de saídaescrita
assign_conversation encaminhar para um colega de equipeescrita
close_conversation marcar como resolvidodestrutiva
list_contacts buscar contatos e estágio do leadleitura
get_contact buscar um contatoleitura
update_contact corrigir nome, email, estágio do leadescrita
list_channels listar plataformas conectadasleitura
set_channel_ai_replies ativar ou desativar respostas automáticas de DM por IA para um canalescrita
list_comments listar comentários de posts do Instagram/Facebookleitura
get_comment buscar um comentário rastreadoleitura
reply_to_comment publicar uma resposta pública sob um comentárioescrita
set_comment_ai_replies ativar ou desativar respostas automáticas de comentários por IA em toda a organizaçãoescrita
get_analytics_summary estatísticas do painel por intervalo de dataleitura
get_usage uso da API e margem do planoLeitura
list_templates status de templates, categorias, componentesleitura
get_template buscar um template por IDleitura
validate_template verificar adequação de categoria e orientação UTILITYleitura
validate_template_draft pré-validar novas ideias de templateleitura
submit_template enviar um template ao Meta para aprovaçãoescrita
submit_stored_template enviar um rascunho existenteescrita
delete_template remover templates obsoletos do Metadestrutiva
send_whatsapp_template disparar um envio aprovado pelo WhatsAppescrita
trigger_journey inscrever um telefone em uma jornadaescrita
trigger_journey_batch inscrição em massa de até 100 destinatáriosescrita
validate_journey_trigger simular telefone, jornada, metadadosleitura
check_journey_status consultar estado de entrega da inscriçãoleitura
list_journey_history histórico recente de inscrições e enviosleitura
explain_delivery_failure explicação em linguagem simples de um envio falholeitura
get_developer_onboarding checklist de integração — o que está feito, o que vem a seguirleitura
get_developer_capabilities mapa atual de escopo da chave de APIleitura
get_developer_limits limites de taxa e margem de cotal Leitura
recommend_plan adequação do plano por canais, volume e tamanho da equipeleitura
ask_barq entregar uma tarefa ao Barq, o agente no appescrita
list_pending_approvals ações que o Barq aguarda sua aprovaçãoleitura
decide_approval aprovar ou rejeitar uma ação pendente do Barqescrita

Prompts · 11

Comandos de barra para o trabalho que você já faz.

Clientes MCP expõem esses prompts como comandos reutilizáveis. Combine-os com os pacotes de habilidades InstantReply para download, para que o agente conheça o ciclo de aprovação, as regras de reescrita Utility, as jogadas de crescimento do proprietário, os runbooks de integração e as proteções para ações destrutivas.

/draft_reply

Rascunhe uma resposta no tom da equipe com base nas últimas três respostas.

/summarize_conversation

Três frases. Objetivo do cliente, estado atual, o que o desbloqueia.

/find_urgent_unanswered

Classifique conversas abertas por probabilidade de churn.

/weekly_inbox_digest

Vitórias, regressões, variações de tempo de resposta. Pronto para colar.

/suggest_macros

Traga respostas repetidas que valem a pena virar respostas prontas.

/escalation_note

Nota interna de transferência. Risco primeiro, contexto depois.

/audit_template_cost

Verifique cada template pendente — sinalize frases MARKETING, estime economia se reescrito como UTILITY.

/utility_rewrite_loop

Reescreva, envie, consulte e relate templates que realmente se qualificam como UTILITY.

/journey_recommendation

Transforme eventos de produto em nomes de gatilho, variáveis, jornadas e verificações de entrega.

/image_to_whatsapp_template_brief

Use uma imagem ou ativo de produto para propor briefs de template do WhatsApp em conformidade.

/debug_last_failure

Explique a última falha de entrega em linguagem simples e sugira o próximo passo.

Habilidades do agente

Baixe os playbooks operacionais.

Instale o servidor MCP para ferramentas ao vivo e adicione estas habilidades para ensinar o agente a executar os fluxos de trabalho do negócio: auditorias de crescimento, política do WhatsApp, criação de templates e integração de desenvolvedores.

Operador de WhatsAppExecute aprovação de templates, reescritas Utility, consultas, limpeza, envios e depuração de entregas.Baixar →
Crescimento do Proprietário do NegócioEncontre leads perdidos, não comparecimentos, vazamentos de suporte, ciclos de avaliação e a próxima automação útil.Baixar →
Melhores Práticas do WhatsAppRevise templates, opt-ins, jornadas, categorias, riscos de qualidade e ciclos de aprovação.Baixar →
Integração de APIGuie desenvolvedores por escopos, webhooks, tentativas, idempotência, jornadas e rastreamento de entregas.Baixar →
Estúdio CriativoTransforme ofertas, eventos de cliente e imagens em briefs de template do WhatsApp seguros por categoria.Baixar →

Clientes

Adicione o bloco. Escolha seu editor.

Claude Code ~/.claude/mcp.json Guia de configuração →
Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json Guia de configuração →
Cursor ~/.cursor/mcp_servers.json Guia de configuração →
Windsurf ~/.codeium/windsurf/mcp_config.json Guia de configuração →
Zed Zed → Settings → Assistant → Context Servers Guia de configuração →
Ações do ChatGPT Custom GPT → Actions → Import OpenAPI Guia de configuração →
Claude.ai (remoto) Settings → Connectors → Add custom connector → https://api.instantreply.co/mcp
Qualquer host MCP stdio transport · npx -y @instantreply.co/mcp

Fluxos de trabalho do WhatsApp · conversacional

Peça em vez de clicar.

O servidor MCP expõe as mesmas APIs de ciclo de vida de templates e depuração de entregas como ferramentas conversacionais. Você pode conduzir o fluxo de trabalho completo — validar, reformular, enviar, depurar — sem abrir o Meta Business Manager ou ler códigos de erro.

Orientação UTILITY de templates

Pergunte: "Verifique meus templates pendentes e me diga quais se qualificam como UTILITY." A ferramenta validate_template retorna frases sinalizadas de marketing e reescritas seguras por categoria. Templates Utility costumam ser mais baratos que Marketing quando a mensagem é realmente transacional.

Enviar ao Meta

Assim que a orientação estiver clara, peça: "Corrija as frases sinalizadas e envie." A ferramenta submit_template encaminha o template corrigido ao Meta e retorna o status de aprovação.

Explicar uma falha de entrega

Pergunte: "Por que a última mensagem da campanha falhou para o contato X?" A ferramenta explain_delivery_failure retorna o que aconteceu, se a culpa é nossa ou do Meta e se uma nova tentativa é segura.

Checklist de integração para desenvolvedores

Pergunte: "Quais etapas de integração ainda estão incompletas?" A ferramenta get_developer_onboarding retorna um checklist de quais etapas estão feitas e quais não — conectar canal, validar primeiro template, registrar webhook.

Permissões · escopos

A chave controla o que o agente pode fazer.

Toda ferramenta MCP mapeia para um escopo de chave de API. Ferramentas de leitura exigem conversations:read. Ferramentas de escrita exigem messages:send. Ferramentas de template exigem templates:write para validar e templates:submit para enviar.

Use uma chave somente leitura para sessões de agente que devem apenas observar. Use uma chave de escopo total para agentes que enviam mensagens ou enviam templates. Ambos os tipos de chave funcionam com a mesma configuração de servidor — basta trocar o valor da chave.

O emparelhamento sem chave concede um conjunto inicial de escopos: conversas (leitura e escrita), contatos (leitura e escrita), envio de mensagens e análises. O envio de templates precisa de templates:write e templates:submit, que não estão nesse conjunto inicial — gere uma chave dedicada no painel para esse fluxo de trabalho.

Toda ferramenta anuncia readOnlyHint e destructiveHint para que clientes MCP compatíveis peçam confirmação antes de qualquer ação de escrita.

# Read-only agent: observe and debug
IR_API_KEY=ir_live_...  # scopes: conversations:read

# Full agent: validate, submit, send
IR_API_KEY=ir_live_...  # scopes: conversations:read,
                        #   messages:send,
                        #   templates:write,
                        #   templates:submit

FAQ

O que agentes e desenvolvedores realmente perguntam.

Preciso de uma chave de API antes de usar este servidor MCP?

Não. Adicione o bloco de configuração sem variáveis de ambiente e peça ao seu agente para conectar. Ele chama start_setup, que retorna um código curto e um link usando o mesmo fluxo de Concessão de Autorização de Dispositivo OAuth 2.0 que o gh auth login usa (RFC 8628). Aprove em um navegador e, em seguida, check_setup captura a chave automaticamente e a armazena em ~/.instantreply/config.json. Reinicie a conexão MCP uma vez e o conjunto completo de ferramentas carrega.

Quantas ferramentas, prompts e recursos o servidor expõe?

34 ferramentas após o emparelhamento — 33 ferramentas autenticadas cobrindo conversas, contatos, templates, jornadas e depuração de entregas, além de get_connection_guide, que não precisa de chave e está sempre ativa. Há também 11 prompts (comandos de barra como /audit_template_cost) e 2 tipos de recurso, conversa e contato. Toda ferramenta declara readOnlyHint e destructiveHint para que um cliente MCP compatível possa pedir antes de escrever ou excluir qualquer coisa.

Quais planos incluem o servidor MCP?

O gratuito obtém ferramentas MCP somente leitura. O Creator não inclui MCP. Todo plano Developer (Dev Hobby, Dev Pro, Dev Scale) e todo plano Business pago (Starter, Growth, Pro) inclui o conjunto completo de ferramentas, com roteamento MCP prioritário no Dev Scale e no Pro.

Qual é a diferença entre uma chave somente leitura e uma chave de escopo total?

Uma chave somente leitura (conversations:read) pode listar e ler conversas, contatos, análises, templates e uso — nada que ela faça altera dados. Enviar uma mensagem exige messages:send. Validar e enviar templates exige templates:write e templates:submit. O emparelhamento sem chave concede um conjunto inicial de escopos (conversas, contatos, envio de mensagens, análises); o envio de templates precisa de uma chave dedicada gerada no painel.

Isso funciona com o ChatGPT?

Sim, de duas formas. Adicione a URL do conector remoto (https://api.instantreply.co/mcp) nos conectores do ChatGPT com o modo desenvolvedor ativado e faça login, ou importe a especificação OpenAPI como uma ação do Custom GPT por meio de Ações de API REST. O servidor stdio local é para clientes de terminal como Claude Code, Cursor, Windsurf e Zed.

Posso conectar sem instalar nada? Sim. No Claude.ai, vá em Configurações → Conectores → Adicionar conector personalizado, cole https://api.instantreply.co/mcp, e faça login no InstantReply. Aprove a tela de consentimento, que mostra quem está solicitando e permite revogar o acesso a qualquer momento em Configurações → Chaves de API. O ChatGPT funciona da mesma forma por meio de conectores no modo desenvolvedor. No Cursor ou Claude Code, execute: claude mcp add --transport http instantreply https://api.instantreply.co/mcp. Novos espaços de trabalho começam com um teste gratuito com acesso total, sem necessidade de cartão.

O agente enviará uma mensagem ou excluirá algo sem me perguntar antes?

Toda ferramenta de escrita e destrutiva — send_message, submit_template, delete_template e as demais — anuncia destructiveHint: true em seus metadados de ferramenta MCP. Um cliente compatível solicita confirmação antes de executá-la. O servidor executa a chamada quando o cliente a envia; ele não envia automaticamente em silêncio por conta própria.