Testar com o MCP Inspector

Este passo é opcional. Você pode pular direto para executar o chat gateway; o Inspector é só a forma mais rápida de conferir que o servidor e suas ferramentas funcionam, sem IA envolvida.

O MCP Inspector é a interface oficial de depuração para servidores MCP. Ele permite navegar pelas ferramentas e chamá-las na mão, sem nenhum modelo de IA no meio, e conferir que uma ferramenta faz o que você acha que ela faz.

Com o servidor rodando em modo HTTP (veja executar o servidor MCP):

npx @modelcontextprotocol/inspector

Depois, na página web do Inspector que se abre:

1. Escolha o tipo de transporte Streamable HTTP.
2. Conecte-se a http://127.0.0.1:8063 (nota: sem o sufixo /mcp).
3. Liste as ferramentas, escolha uma, preencha seus parâmetros e execute.

Você também pode deixar o Inspector iniciar o servidor por conta própria sobre stdio:

npx @modelcontextprotocol/inspector uv run mcp-server

Tip

Quando uma ferramenta que você esperava não aparece na lista, verifique os logs do servidor na inicialização: ferramentas que não seguem o contrato de resultados são puladas com um aviso, não com um erro.