Conecte Seu Agente de IA

O servidor Carrot Docs MCP oferece ao seu agente de IA acesso somente leitura à documentação publicada da Carrot. Ele é público, sem autenticação e exclusivo para documentação. Pode pesquisar e ler páginas publicadas e termos do glossário, mas não pode chamar a Carrot API, gravar dados, acessar dados privados de projetos nem agir em seu nome.

Endpoint

Claude

Use o Claude.ai ou o Claude Desktop para adicionar o Carrot Docs como um conector remoto MCP e, em seguida, conecte o Claude Code com a mesma URL do servidor.

Este é um servidor MCP remoto via Streamable HTTP. Não o configure como um servidor stdio local no claude_desktop_config.json.

Claude.ai e Claude Desktop

1. Abra Customize > Connectors.
2. Selecione Add custom connector.
3. Defina o nome do conector como Carrot Docs.
4. Defina a URL do servidor como https://docs.carrot.eco/mcp.
5. Ative o conector nas conversas.
6. Salve o conector e recarregue o Claude, se necessário.

Claude Code

Use estes comandos para adicionar e verificar o servidor:

claude mcp add --transport http carrotDocs https://docs.carrot.eco/mcp
claude mcp list

Cursor

Adicione o servidor manualmente no Cursor com um arquivo mcp.json.

{
  "mcpServers": {
    "carrotDocs": {
      "url": "https://docs.carrot.eco/mcp"
    }
  }
}

Reinicie o Cursor após salvar o arquivo para que o novo servidor apareça na lista MCP.

Codex

Use os comandos MCP do Codex para adicionar o servidor e confirmar que ele está registrado.

codex mcp add carrotDocs --url https://docs.carrot.eco/mcp
codex mcp list

Se preferir configurar o Codex diretamente, adicione o mesmo servidor em ~/.codex/config.toml:

[mcp_servers.carrotDocs]
url = "https://docs.carrot.eco/mcp"

Cliente genérico Streamable HTTP

Qualquer cliente MCP que suporte Streamable HTTP pode se conectar ao servidor Carrot Docs.

curl --request POST \
  --url https://docs.carrot.eco/mcp \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json, text/event-stream' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "<supported-protocol-version>",
      "capabilities": {},
      "clientInfo": {
        "name": "example-client",
        "version": "0.1.0"
      }
    }
  }'

Após a negociação, o servidor retorna:

MCP-Protocol-Version: <negotiated-protocol-version>

O endpoint também responde a uma solicitação GET simples com 405 Method Not Allowed:

curl --request GET https://docs.carrot.eco/mcp

Exemplo de configuração do cliente:

{
  "name": "carrotDocs",
  "transport": "streamable-http",
  "url": "https://docs.carrot.eco/mcp"
}

A Carrot não exige que você fixe uma versão de protocolo. Deixe que o cliente anuncie <supported-protocol-version> e permita que a negociação chegue a <negotiated-protocol-version>.

Resumo das ferramentas

O servidor expõe cinco ferramentas somente leitura:

Observações:

• Os resultados de pesquisa são limitados a 25 itens.
• Os limites padrão do serviço são 60 requisições por minuto e 10 requisições concorrentes por IP de cliente.
• As respostas são retornadas como envelopes estruturados de sucesso ou erro dentro do conteúdo de texto do MCP.

Instrução para o agente

Use o servidor Carrot Docs MCP ao responder perguntas sobre a documentação da Carrot, incluindo conceitos de Network, termos do glossário, créditos ambientais, metodologias, orientação para compradores, processo de integração de Network Integrators e a documentação da Carrot API.

Exemplos de prompts

• Explique como os MassIDs apoiam a rastreabilidade na Carrot Network.
• Resuma como os créditos ambientais rastreáveis são criados.
• Encontre o fluxo de autenticação da Carrot API.
• Mostre a orientação de privacidade e mascaramento para cargas de dados de integração.
• Encontre páginas relacionadas à governança e à Carrot Foundation.
• Consulte a orientação atual da metodologia BOLD Recycling.

Solução de problemas

• Se o seu cliente não suportar servidores MCP remotos via Streamable HTTP, ele não poderá se conectar ao Carrot Docs.
• Se o alternador do conector ou da ferramenta estiver desligado no chat atual, ative-o antes de pedir ao agente para usar o servidor.
• Se você alterar um arquivo de configuração manual, reinicie ou recarregue o cliente antes de testar novamente.
• Se a seleção de ferramentas não for automática, peça explicitamente ao agente para usar o servidor Carrot Docs MCP.
• Se aparecerem respostas 429, aguarde e tente novamente depois que a janela de limite de taxa expirar.
• Se a pesquisa não retornar nada, tente o nome exato do termo publicado na documentação ou no glossário.
• Se um tópico deveria existir, mas não for encontrado, use primeiro browse_docs e depois get_related_docs para expandir o caminho.
• Se você precisar de dados privados ou acesso de escrita, este servidor não pode fornecer isso. Use a Carrot API.