Anderflow Labs
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 .