Documentação

Agentes de IA (MCP)

Conectar o servidor MCP

Conecte Claude, Claude Code, ChatGPT, Cursor, VS Code ou Codex ao seu workspace do AmICited por MCP. Uma URL, login por OAuth e uma chave de API como alternativa.

O AmICited mantém um servidor MCP (Model Context Protocol) sempre ativo. Depois que seu cliente de IA está conectado, ele pode ler seus dados de visibilidade, executar relatórios e, com acesso de escrita, adicionar prompts, gerar artigos ou registrar anotações, tudo em uma conversa normal. Cada recurso do dashboard também é distribuído como ferramenta MCP, então não há nada que você faça no app que um agente não possa fazer.

Antes de começar#

  • Um plano que inclua o MCP. O MCP está disponível no teste de 7 dias e nos planos Pro, Premium e Enterprise. Os workspaces Starter podem ver a URL do servidor, mas as conexões são recusadas até o plano ser atualizado. Veja planos e limites.
  • Permissões de editor ou superiores no workspace. A página MCP orienta os membros sem elas a pedir a um proprietário ou administrador do workspace.
  • Um saldo de créditos positivo. As leituras por MCP são gratuitas, mas o endpoint verifica se o workspace tem créditos antes de responder. Veja créditos.

A URL do servidor#

Há uma única URL para todos:

text
https://api.flowhunt.io/mcp/amicited

O workspace não está na URL. Ele vem da sua credencial: com OAuth, você escolhe o workspace na tela de consentimento, e uma chave de API já pertence a um workspace. Você também pode copiar a URL da página MCP no app, que a mostra com um botão Copy URL e as mesmas instruções por cliente abaixo. O transporte é HTTP streamable.

Conecte seu cliente#

Escolha seu cliente. Cada aba começa com o login por OAuth recomendado e termina com a alternativa da chave de API.

Claude (web e Desktop)

Os conectores que você adiciona no claude.ai também ficam disponíveis no app Claude Desktop.

  1. Abra as configurações de conectores do Claude.
  2. Clique em + e depois em Add custom connector.
  3. Cole https://api.flowhunt.io/mcp/amicited e clique em Add.
  4. Clique em Connect no novo conector e aprove o acesso na janela do navegador que abrir. Escolha seu workspace na tela de consentimento.

Em um chat, abra o menu de ferramentas e confirme que o conector do AmICited está ativado.

Alternativa com chave de API (arquivo de configuração do Claude Desktop). Adicione isto em mcpServers em ~/Library/Application Support/Claude/claude_desktop_config.json no macOS e reinicie o Claude Desktop:

claude_desktop_config.json
{
  "mcpServers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited",
      "headers": {
        "Authorization": "Bearer <your-workspace-api-key>"
      }
    }
  }
}

Claude Code

Registre o servidor uma vez pelo terminal:

bash
claude mcp add --transport http amicited https://api.flowhunt.io/mcp/amicited

Depois execute /mcp dentro do Claude Code, escolha Authenticate e aprove o acesso na janela do navegador que abrir.

Alternativa com chave de API. Adicione o servidor sob a chave mcpServers de nível superior em ~/.claude.json e reinicie o Claude Code:

~/.claude.json
{
  "mcpServers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited",
      "headers": {
        "Authorization": "Bearer <your-workspace-api-key>"
      }
    }
  }
}

ChatGPT

Os conectores MCP personalizados exigem o Developer mode, disponível nos planos pagos do ChatGPT (Plus, Pro, Team, Enterprise). Em workspaces Business, Enterprise e Edu, um administrador pode precisar ativá-lo para você.

  1. Ative o Developer mode conforme descrito na documentação de conectores da OpenAI.
  2. No ChatGPT, abra Settings e depois Apps & Connectors.
  3. Adicione um conector personalizado e cole https://api.flowhunt.io/mcp/amicited.
  4. Aprove o acesso na janela do navegador que abrir.

Alternativa com chave de API. Na etapa 4, escolha a autenticação por chave de API e cole a chave de API do seu workspace. Salve o conector e depois ative-o em um novo chat.

Cursor

Na página MCP do app, selecione Cursor e clique em Add to Cursor. O Cursor instala o servidor e faz o login para você.

Se o botão não abrir o Cursor, adicione o servidor manualmente nas configurações do Cursor, em MCP, ou edite ~/.cursor/mcp.json (ou um .cursor/mcp.json por projeto):

~/.cursor/mcp.json
{
  "mcpServers": {
    "amicited": {
      "url": "https://api.flowhunt.io/mcp/amicited"
    }
  }
}

O Cursor abre um navegador para o login na primeira vez que se conecta. Defina o chat como modo Agent para usar as ferramentas.

Alternativa com chave de API. Adicione um cabeçalho à mesma entrada:

json
"headers": { "Authorization": "Bearer <your-workspace-api-key>" }

VS Code

O VS Code usa o servidor por meio do GitHub Copilot no modo Agent, então o Copilot precisa estar ativado.

Na página MCP do app, selecione VS Code e clique em Add to VS Code. O VS Code instala o servidor e faz o login para você.

Para adicioná-lo manualmente, abra a Command Palette, execute MCP: Open User Configuration e adicione o servidor em servers:

mcp.json
{
  "servers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited"
    }
  }
}

Alternativa com chave de API. Adicione "headers": { "Authorization": "Bearer <your-workspace-api-key>" } à entrada. Você também pode executar MCP: Add Server…, escolher HTTP (HTTP or Server-Sent Events), colar a URL e adicionar o cabeçalho Authorization quando solicitado.

Codex

O Codex se conecta como um cliente MCP remoto padrão. Adicione o servidor e depois faça o login:

bash
codex mcp add amicited --url https://api.flowhunt.io/mcp/amicited
codex mcp login amicited

Ou edite ~/.codex/config.toml diretamente:

~/.codex/config.toml
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
oauth_resource = "https://api.flowhunt.io/mcp/amicited"

Alternativa com chave de API. Coloque a chave em uma variável de ambiente e aponte o Codex para ela:

~/.codex/config.toml
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
bearer_token_env_var = "AMICITED_API_KEY"

Um Codex executado com configurações de aprovação rígidas ainda alcança todas as ferramentas somente leitura por read_tool. Veja toolsets e ferramentas.

OAuth ou chave de API#

OAuth 2.1 (recomendado)Chave de API do workspace (alternativa)
ConfiguraçãoCole a URL e aprove no navegadorCole a URL mais um cabeçalho Authorization: Bearer
WorkspaceEscolhido na tela de consentimentoFixado pela chave
Permissõesamicited:read para conectar e ler; amicited:write também é necessário para escritaAcesso total ao workspace
RevogaçãoConnected clients → Revoke na página MCPExclua ou faça a chave expirar

O OAuth é o melhor padrão: não há segredo para colar em um arquivo de configuração, cada cliente aparece pelo nome na página MCP, em Connected clients, e você pode revogar um sem tocar nos outros. Um token OAuth somente leitura pode listar e ler tudo, mas qualquer ferramenta que cria, edita ou exclui recusará com uma mensagem que cita o escopo amicited:write. Tentar de novo não ajuda; reconecte com acesso de escrita.

Trate uma chave de API como uma senha

Qualquer pessoa com uma chave de API do workspace pode executar todas as ferramentas do servidor sobre os dados do seu workspace, inclusive escrita. Prefira o OAuth, mantenha as chaves fora de repositórios compartilhados e use uma variável de ambiente quando seu cliente permitir.

Verifique se funciona#

Peça algo pequeno ao seu agente: “List my AmICited domains.” Ele deve chamar list_domains e devolver seus domínios pelo nome. Depois tente “Show my AI visibility for the last 30 days”, que usa prompt_analytics.

Se a conexão for recusada, a mensagem geralmente diz o motivo:

  • Plano. “requires a Pro plan or above”: o plano do proprietário do workspace não inclui o MCP.
  • Créditos. O saldo do workspace é zero ou negativo. Recarregue e tente de novo.
  • Limite de taxa. As chamadas de ferramentas têm um limite por workspace por hora: 120 no teste, 600 no Pro, 2.000 no Premium, ilimitado no Enterprise. A mensagem diz quando a janela é reiniciada. Listar ferramentas e ler skills não contam.

Relacionados#