Quando o openapi-mcp-server encontra um problema que o Claude não reconhece, você pode seguir as etapas abaixo para solucionar o problema:
- Verificar o caminho da configuraçãoVerifique se os caminhos para os arquivos OpenAPI especificados no arquivo de configuração do Claude estão corretos, especialmente se os caminhos relativos e absolutos são usados de forma consistente
- Verifique a especificação da OpenAPIUse ferramentas on-line, como https://editor.swagger.io验证OpenAPI文件是否符合v3.1标准规范
- Verificação do status do servidorVerifique se o openapi-mcp-server está instalado e funcionando com êxito; você pode tentar executar o teste diretamente da linha de comando.
npx openapi-mcp-server examples/petstore-openapi.json - Reiniciar o Claude DesktopÉ necessária uma reinicialização completa do aplicativo Claude Desktop para que as alterações tenham efeito.
- Visualização de mensagens de registroVerifique se há mensagens de erro na janela da linha de comando ou nos arquivos de registro, prestando atenção especial à conversão da API e às mensagens relacionadas ao carregamento.
- Exemplo simples de testePrimeiro, use o exemplo da API Petstore que acompanha o projeto para confirmar que a funcionalidade básica está funcionando e para restringir o escopo do problema
Se o problema ainda não tiver sido resolvido, consulte a seção de problemas do repositório do GitHub ou envie um novo problema para obter ajuda da comunidade. Verifique também se você está usando a versão mais recente do openapi-mcp-server.
Essa resposta foi extraída do artigoopenapi-mcp-server: permite que a IA invoque diretamente os serviços MCP com APIs abertasO