Modem

O Modem conecta IA a feedbacks de clientes em Slack, suporte, e-mail, chamadas e rastreadores de problemas, transformando-os em insights consultáveis que você pode usar para agir.

Ver em modem.devExperimente este MCPPatrocinado

Documentação

Servidor MCP Modem

Pesquise, atualize e execute o Agente Modem a partir de clientes MCP externos

export const Prompt = ({text, variant = 'accent'}) => { const [copied, setCopied] = useState(false); const handleCopy = async () => { try { await navigator.clipboard.writeText(text); setCopied(true); setTimeout(() => setCopied(false), 2000); } catch {} }; const clipboardIcon = Copiar ; const checkIcon = Copiado ; const promptIcon = <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style={{ flexShrink: 0, opacity: 0.4 }}> Prompt ; return <div className={prompt prompt-${variant}} style={{ marginTop: '12px', marginBottom: '12px' }}> {promptIcon} {text} {copied ? checkIcon : clipboardIcon} ; };

O Servidor MCP Modem permite que clientes compatíveis com MCP trabalhem com o Modem fora do painel do Modem. Use-o quando quiser que um assistente externo pesquise seus feedbacks de clientes, tópicos, pessoas e empresas, execute o Agente Modem em suas ferramentas conectadas ou atualize seu espaço de trabalho Modem diretamente.

Info

Esta página trata de conectar um cliente MCP externo ao Modem. Para conectar servidores de ferramentas MCP externos para uso do Agente Modem, consulte a página de Servidores MCP Externos.

URL do servidor

Use esta URL no seu cliente MCP:

https://mcp.modem.dev/mcp

O servidor usa Streamable HTTP e OAuth. Você não precisa criar ou colar uma chave de API.

Ferramentas

O servidor expõe três tipos de ferramentas: uma que executa o Agente Modem completo, uma que lê seus dados diretamente e um conjunto que grava no seu espaço de trabalho Modem.

Quais ferramentas seu cliente vê depende dos escopos que você aprova durante a autorização. Consulte Segurança e Acesso.

Para a lista completa de parâmetros de cada ferramenta, formato de resultado e exemplos de invocação, consulte a Referência de Ferramentas MCP.

Executar o agente

As execuções do agente são assíncronas. Iniciar uma execução retorna seus IDs imediatamente. A execução continua no Modem, mesmo que seu cliente MCP se desconecte.

Ferramenta	O que faz	Entradas
`modem_agent_invoke`	Inicia uma nova conversa com o agente e retorna seus `conversation_id` e `run_id`.	`prompt`, `idempotency_key`
`modem_agent_get_run`	Retorna o status atual e, quando concluída, a resposta do agente.	`conversation_id`, `run_id`
`modem_agent_send_message`	Inicia uma rodada de acompanhamento em uma conversa MCP existente.	`conversation_id`, `prompt`, `idempotency_key`
`modem_agent_cancel_run`	Solicita o cancelamento de uma execução. Ações que o agente já concluiu não são revertidas.	`conversation_id`, `run_id`

Use estas ferramentas quando a tarefa exigir raciocínio, várias etapas ou suas ferramentas conectadas, como Linear, Slack ou GitHub. As execuções do agente consomem créditos.

Como funciona uma execução do agente

Chame `modem_agent_invoke` com um prompt e um `idempotency_key`. O Modem retorna `conversation_id`, `run_id` e um status `working`. Chame `modem_agent_get_run` com ambos os IDs. Continue verificando até que o status seja `completed`, `failed` ou `cancelled`. Uma execução concluída inclui a resposta em `result.text`. Chame `modem_agent_send_message` com o mesmo `conversation_id`, um novo prompt e um novo `idempotency_key`. Aguarde a execução atual terminar antes de iniciar o acompanhamento. Chame `modem_agent_cancel_run` com os IDs da conversa e da execução. O cancelamento interrompe o trabalho restante, mas não desfaz ações que o agente já concluiu.

Salve os IDs da conversa e da execução após cada chamada de início. Você pode usá-los para verificar a execução a partir de uma nova conexão se o cliente original sair.

Chaves de idempotência

Dê a cada rodada lógica uma idempotency_key estável e única.

Repita a mesma rodada com a mesma chave e exatamente o mesmo prompt. O Modem retorna a execução existente em vez de iniciar outra.
Não reutilize uma chave com um prompt alterado. O Modem a rejeita como conflito.
Inicie cada acompanhamento com uma nova chave. Apenas uma rodada pode ser executada em uma conversa por vez.

Os prompts podem conter até 50.000 caracteres. Todas as quatro ferramentas de execução do agente exigem o escopo agent:invoke.

Pesquisar seus dados

Ferramenta	O que faz	Escopo
`search_modem`	Responde a uma pergunta em linguagem natural sobre seus dados do Modem e retorna as linhas correspondentes.	`data:read`

search_modem é somente leitura e não executa o Agente Modem completo nem consome créditos do agente. Prefira-a para consultas e busca semântica. É mais rápida e mais barata que modem_agent_invoke.

Gravar no seu espaço de trabalho

Estas ferramentas aplicam alterações diretamente, sem passar pelo agente.

Ferramenta	O que faz
`update_topic`	Atualiza um único tópico: prioridade, estado do ciclo de vida, tipo de problema, palavras-chave ou status de arquivamento.
`bulk_update_topics`	Atualiza até 100 tópicos de uma vez, como arquivar ou redefinir prioridades de um conjunto.
`merge_topics`	Mescla até 50 tópicos de origem em um tópico de destino.
`create_companies`	Cria até 50 empresas. Cada uma precisa de um `name` e um `domain`.
`update_companies`	Atualiza até 50 empresas existentes: nome, domínio principal, logotipo, status VIP ou conexões.
`merge_companies`	Mescla empresas de origem em uma empresa de destino, que é a mantida.
`add_people_to_company`	Associa uma ou mais pessoas a uma empresa.
`update_people`	Atualiza até 50 pessoas existentes: nome de exibição, e-mail, descrição, status VIP ou conexões.
`merge_people`	Mescla pessoas de origem em uma pessoa de destino, que é a mantida.

Todas as ferramentas de gravação exigem o escopo agent:invoke e são marcadas como destrutivas, então a maioria dos clientes MCP pede que você confirme cada chamada antes de executá-la.

Aviso

As ferramentas de gravação aplicam alterações imediatamente e o Modem não as desfaz por você. Mesclagens em particular não são reversíveis a partir do cliente MCP, então confirme se o destino está correto antes de aprovar a chamada.

Permissões

As ferramentas de gravação agem como você, não como uma conta de serviço. Cada uma é executada com base no seu papel existente na organização que você selecionou durante a autorização, aplicado da mesma forma que no painel do Modem. Se sua conta não puder fazer uma alteração no painel, a ferramenta também não poderá fazê-la. Se sua conta não for membro da organização selecionada, a chamada será rejeitada.

Valores de campos

Alguns campos aceitam apenas um conjunto fixo de valores:

Campo	Valores aceitos
`priority`	`very_low`, `low`, `default`, `high`, `very_high`
`lifecycleState`	`open`, `in_progress`, `completed`, `dismissed`
`issueType`	`bug_report`, `feature_request`, `complaint`, `praise`, `discussion`

Os IDs de tópicos são UUIDs. Os IDs de empresas e pessoas são strings numéricas. Use search_modem para encontrar os IDs necessários antes de chamar uma ferramenta de gravação.

Pré-requisitos

Uma conta Modem com acesso à organização que você deseja usar
Um cliente MCP que suporte servidores remotos Streamable HTTP com OAuth

O suporte do cliente muda rapidamente. Os exemplos abaixo cobrem clientes MCP comuns com suporte HTTP remoto. Seu cliente pode usar rótulos ligeiramente diferentes para os mesmos campos, e ele deve suportar OAuth para o servidor do Modem.

Configure seu cliente

Use o caminho de configuração para seu cliente MCP. Em todos os casos, a URL do servidor é:

https://mcp.modem.dev/mcp

Claude Code

O Claude Code pode adicionar servidores MCP HTTP remotos a partir da CLI.

claude mcp add --transport http modem https://mcp.modem.dev/mcp

Em seguida, execute /mcp dentro do Claude Code e conclua o fluxo de autorização no navegador.

Cursor

No Cursor, abra Configurações → Configurações do Cursor → Ferramentas e MCP e adicione um novo servidor MCP. O Cursor armazena a configuração MCP em um arquivo mcp.json.

{
    "mcpServers": {
        "modem": {
            "url": "https://mcp.modem.dev/mcp"
        }
    }
}

Se o Cursor pedir um tipo de transporte, escolha Streamable HTTP.

VS Code e GitHub Copilot

O VS Code armazena a configuração MCP em um arquivo mcp.json, seja no seu perfil de usuário ou em .vscode/mcp.json para um espaço de trabalho.

{
    "servers": {
        "modem": {
            "type": "http",
            "url": "https://mcp.modem.dev/mcp"
        }
    }
}

Use MCP: Adicionar Servidor ou MCP: Abrir Configuração do Usuário na paleta de comandos se preferir editar pelo VS Code.

Codex

O Codex pode adicionar servidores MCP remotos a partir da CLI.

codex mcp add modem --url https://mcp.modem.dev/mcp

Em seguida, autorize o servidor, o que abre o fluxo no navegador:

codex mcp login modem

O Codex armazena a configuração MCP em ~/.codex/config.toml se você preferir editá-la diretamente. auth usa como padrão oauth, então pode ser omitido.

[mcp_servers.modem]
url = "https://mcp.modem.dev/mcp"
auth = "oauth"

opencode

O opencode armazena a configuração MCP em opencode.json. Use "type": "remote" para o servidor Modem.

{
    "$schema": "https://opencode.ai/config.json",
    "mcp": {
        "modem": {
            "type": "remote",
            "url": "https://mcp.modem.dev/mcp"
        }
    }
}

Deixe o campo headers de fora. O Modem usa OAuth, então não há chave de API para passar. O opencode solicita que você autorize na primeira vez que usar o servidor, ou você pode acionar o fluxo manualmente:

opencode mcp auth modem

ChatGPT

O ChatGPT se conecta a servidores MCP remotos por meio do modo Desenvolvedor, disponível em planos pagos. A disponibilidade pode depender da política da sua conta e do espaço de trabalho, e a OpenAI moveu a configuração entre menus, então verifique os dois locais abaixo.

Abra as Configurações do ChatGPT e ative o modo Desenvolvedor. Dependendo da versão do seu ChatGPT, ele fica em Segurança e login ou em Apps (anteriormente Conectores) → Configurações avançadas.
Na lista de apps/conectores, clique no botão adicionar (+) para criar uma nova conexão.
Dê um nome como Modem e insira a URL do servidor https://mcp.modem.dev/mcp.
Se for solicitado um tipo de autenticação, escolha OAuth. Crie a conexão.
Conclua o fluxo de autorização do Modem na janela do navegador que abrir e revise as ferramentas descobertas.

Em uma conversa, ative a conexão Modem no menu de ferramentas do compositor e faça perguntas que a utilizem. O ChatGPT pede confirmação antes de executar ferramentas de gravação.

Outros clientes MCP

Use o fluxo de configuração HTTP remoto ou Streamable HTTP do cliente. Se ele pedir campos, use:

Campo	Valor
Nome	`modem`
URL	`https://mcp.modem.dev/mcp`
Transporte	Streamable HTTP ou HTTP
Autenticação	OAuth

Documentação MCP específica do cliente:

Cliente	Documentação
Claude Code	Conecte o Claude Code a ferramentas via MCP
ChatGPT	Conecte um servidor MCP remoto ao ChatGPT
Cursor	Documentação MCP do Cursor
VS Code	Referência de configuração do MCP
Codex	Documentação MCP do Codex
opencode	Servidores MCP do opencode

Autorizar o Modem

Seu cliente MCP deve abrir uma janela do navegador para autorização OAuth na primeira conexão.

Na tela de consentimento do Modem:

Confirme o nome do cliente solicitante.
Revise o destino do redirecionamento.
Escolha a organização do Modem se sua conta pertencer a mais de uma.
Aprove as permissões solicitadas.

Após a autorização ser concluída, seu cliente MCP pode chamar as ferramentas MCP do Modem.

Seu cliente vê apenas as ferramentas cobertas pelos escopos que você aprovou. Um token com data:read mas sem agent:invoke vê search_modem e nada mais.

Exemplos de Prompts

Seu cliente MCP escolhe a ferramenta, então formule a solicitação para o resultado desejado. Os exemplos abaixo tendem a selecionar a ferramenta indicada ao lado deles.

Consultas e perguntas, que normalmente roteiam para search_modem:

Trabalho de múltiplas etapas e qualquer coisa envolvendo ferramentas conectadas, que normalmente roteia para modem_agent_invoke:

Alterações no seu espaço de trabalho, que normalmente roteiam para as ferramentas de escrita:

Para uma nova tarefa, inclua o contexto que o agente precisa no primeiro prompt. Para continuar uma execução, peça ao seu cliente para enviar um acompanhamento na conversa existente do Modem.

Segurança e Acesso

O Modem autoriza o cliente MCP com OAuth. O token de acesso é limitado à conta e organização do Modem selecionadas durante o consentimento.

As permissões MCP são:

Escopo	Significado	Ferramentas que expõe
`agent:invoke`	Executar o Agente Modem em seu nome e aplicar alterações ao seu espaço de trabalho como você.	Quatro ferramentas de execução do agente e as ferramentas de escrita do espaço de trabalho
`data:read`	Ler seus dados do Modem por meio de busca em linguagem natural. Não executa o agente pago.	`search_modem`

O servidor MCP resolve a organização a partir das declarações do token OAuth, não da URL. Mantenha a URL do servidor como https://mcp.modem.dev/mcp.

As ferramentas de escrita também aplicam seu próprio papel nessa organização em cada chamada, então um token aprovado nunca concede mais acesso do que sua conta Modem já possui.

Limites de taxa

As chamadas de ferramentas MCP são limitadas por organização, por ferramenta, a 20 chamadas por minuto. Exceder o limite retorna um erro de limite de taxa com uma dica retryAfter para o seu cliente recuar. modem_agent_invoke está adicionalmente sujeito aos limites de crédito do agente da sua organização.

Solução de Problemas

Confirme que a URL do servidor é exatamente `https://mcp.modem.dev/mcp`.
Reinicie o cliente ou recarregue a lista de servidores MCP dele.
Certifique-se de que seu cliente suporta servidores MCP remotos Streamable HTTP com OAuth.

As ferramentas são expostas por escopo. Se você vê `search_modem` mas nenhuma ferramenta de agente ou escrita, seu token carrega `data:read` mas não `agent:invoke`. Execute novamente o fluxo OAuth e aprove ambas as permissões.

Entre com a conta Modem que pertence à organização que você selecionou.
Execute novamente o fluxo OAuth e aprove as permissões solicitadas.
Se a autorização ainda falhar, entre em contato com o suporte do Modem.

As ferramentas de escrita operam como você, sob seu papel na organização selecionada. Confirme que sua conta pode fazer a mesma alteração no painel do Modem e que ela é membro da organização que você autorizou. As chamadas de ferramentas MCP são limitadas a 20 por minuto por organização, por ferramenta. Aguarde o intervalo `retryAfter` no erro e tente novamente com recuo. Se `modem_agent_invoke` for rejeitado por custo em vez de taxa, verifique a permissão de crédito do agente da sua organização. `modem_agent_invoke` e `modem_agent_send_message` retornam assim que o Modem aceita a execução. Use o `conversation_id` e o `run_id` retornados com `modem_agent_get_run` até que a execução alcance um status final. Aguarde a execução atual terminar antes de enviar outra mensagem na mesma conversa. Se você estiver tentando novamente uma solicitação, reutilize seu `idempotency_key` somente quando o prompt não tiver sido alterado. Reconecte e chame `modem_agent_get_run` com o `conversation_id` e o `run_id` retornados quando a execução começou. O Modem continua execuções aceitas após a conexão MCP original ser fechada. Remova ou desconecte o servidor MCP do Modem no seu cliente, depois autorize novamente e selecione a organização correta na tela de consentimento do Modem.

Relacionados

Saiba o que o Agente Modem pode consultar e fazer. Conecte servidores de ferramentas MCP externos para o Agente Modem usar.