Anderflow LabsConversar sobre um projeto

Servidor MCP da Anderflow Labs

Guia oficial do servidor MCP da Anderflow Labs, com endpoint Streamable HTTP, ferramentas públicas e exemplos JSON-RPC executáveis.

Endpoint da API MCP e protocolo

O servidor com.anderflow/public-site oferece consultas públicas sobre a Anderflow Labs no endpoint https://anderflow.com/mcp. Ele implementa Streamable HTTP com respostas JSON, sem autenticação e sem sessão.

A versão preferida do protocolo é 2025-11-25; o servidor também aceita 2025-06-18 e 2025-03-26. Depois de initialize, utilize a versão devolvida em result.protocolVersion. O servidor não oferece um fluxo SSE independente: GET /mcp retorna HTTP 405. Para ler este guia, use /mcp.html.

Os comandos abaixo usam curl em um terminal POSIX, como bash ou zsh. São quatro etapas de conexão e consulta, sem dados pessoais ou operações de escrita.

1. Inicializar o cliente MCP

Envie initialize com protocolVersion, capabilities e clientInfo. A resposta HTTP 200 informa a versão negociada, serverInfo e a capacidade tools. Neste servidor, não há cabeçalho de sessão para reutilizar.

curl --silent --show-error 'https://anderflow.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  --data '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {
      "name": "anderflow-docs-example",
      "version": "1.0.0"
    }
  }
}'

2. Confirmar a inicialização

Envie notifications/initialized sem id. O servidor aceita essa notificação com HTTP 202 e corpo vazio; uma notificação não recebe uma resposta JSON-RPC.

curl --silent --show-error 'https://anderflow.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  --data '{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}'

3. Descobrir as ferramentas e os parâmetros

tools/list devolve as duas ferramentas, suas descrições, inputSchema e anotações de leitura. A lista completa é retornada sem paginação. Use o enum de path em get_public_page para identificar as páginas permitidas.

curl --silent --show-error 'https://anderflow.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  --data '{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}'

4. Consultar informações públicas da empresa

get_business_info recebe arguments: {}. Retorna name, url, description, sameAs, services e pages, sempre com conteúdo público. Propriedades adicionais nos argumentos são rejeitadas.

O resultado é apresentado em content, como texto JSON. Para as versões 2025-06-18 e 2025-11-25, também é fornecido em structuredContent. Uma execução bem-sucedida informa isError: false.

curl --silent --show-error 'https://anderflow.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  --data '{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_business_info",
    "arguments": {}
  }
}'

Ler uma página com get_public_page

Este exemplo consulta a página inicial. O resultado contém url, title e markdown. Substitua / somente por outro caminho canônico permitido no inputSchema de tools/list; URLs externas e caminhos arbitrários não são aceitos.

curl --silent --show-error 'https://anderflow.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  --data '{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "get_public_page",
    "arguments": {
      "path": "/"
    }
  }
}'

Limites e respostas que o cliente deve tratar

  • Cada corpo JSON pode ter até 16.000 bytes. Corpos maiores retornam HTTP 413.
  • O limite é global de 120 requisições POST por minuto por processo. HTTP 429 inclui Retry-After; aguarde o intervalo informado antes de consultar novamente.
  • Quando o cabeçalho Origin é enviado, seu valor deve ser exatamente https://anderflow.com. Outra origem retorna HTTP 403. Clientes MCP sem esse cabeçalho podem consultar o endpoint público.
  • Content-Type diferente de application/json retorna HTTP 415. O cabeçalho Accept precisa aceitar application/json e text/event-stream; uma combinação incompatível retorna HTTP 406.
  • Um MCP-Protocol-Version não suportado retorna HTTP 400. JSON inválido recebe erro JSON-RPC de análise; método desconhecido ou argumentos inválidos recebem erros JSON-RPC correspondentes.
  • O servidor não mantém sessões e não oferece SSE independente, gravação, envio de mensagens ou execução de ações comerciais. As ferramentas declaram readOnlyHint: true.

Documentos de descoberta e referência

Atualizado em .