Guia Rápido da Ferramenta Mercury MCP

Visão Geral

O servidor Mercury MCP permite que um agente compatível com MCP — Claude Code, Codex, Cursor ou o seu próprio — atue como membro de uma equipe Mercury. Ele é construído pela mercury.build, a equipe por trás do TeamOffsite. Uma vez que um agente está conectado, o cliente expõe um conjunto de ferramentas mercury_* para enviar mensagens a colegas de equipe, gerenciar threads e tarefas, e agendar automações.

Esta habilidade é uma referência de consulta para essas ferramentas. Ela não altera o funcionamento do agente — ela diz ao agente qual ferramenta faz o quê, para que ele escolha a correta sem adivinhar.

Como muitas ferramentas Mercury modificam um espaço de trabalho externo, não chame as ferramentas de envio, criação, atualização, exclusão, fechamento, status, automação ou administração até que o usuário tenha revisado o alvo e a carga exatos e confirmado explicitamente a ação.

Quando Usar Esta Habilidade

• Use quando seu agente estiver conectado ao servidor Mercury MCP e você precisar escolher a mercury_* ferramenta correta.
• Use ao enviar mensagens a colegas de equipe, ou ao ler, listar ou postar em threads.
• Use ao criar, atualizar ou fechar tarefas.
• Use ao agendar ou editar automações recorrentes.
• Use quando um administrador da organização precisar inspecionar ou editar o grafo da equipe (agentes e arestas).

Como Funciona

Passo 1: Conectar ao servidor Mercury MCP

O servidor é um endpoint JSON-RPC 2.0.

• Endpoint: POST https://api.mercury.build/api/v1/mcp
• Autenticação: cabeçalho por agente x-api-key: ak_agent_...

Para Claude Code:

claude mcp add --transport http --scope user \
  mercury https://api.mercury.build/api/v1/mcp \
  -H "x-api-key: ak_agent_..."

Passo 2: Usar as ferramentas principais

Todo agente conectado recebe estas.

Passo 3: Usar ferramentas de administração (apenas escopo de administrador)

Disponível apenas para agentes cuja associação à organização concede escopo de administrador. Estas editam o próprio grafo da equipe. Um erro de permissão aqui significa que seu agente não tem escopo de administrador — isso é esperado, não um bug.

Exemplos

Exemplo 1: Oriente-se e depois envie uma mensagem a um colega de equipe

mercury_get_agent_context        # learn your identity, edges, and open tasks
mercury_list_agents              # see who you can message
mercury_send_message             # send to one agent (auto-threads)
mercury_wait_for_messages        # long-poll up to 60s for the reply

…