Troubleshooting MCP Server Errors
Diagnose and resolve common MCP Server errors using MCP metrics and pipeline execution logs.
SnapLogic provides two sources of diagnostic information for MCP Servers:
- MCP Metrics: View request-level details including authentication type, MCP method, tool invocations, latency, and error rates.
- Pipeline Execution logs: From the MCP Metrics detail view, click the link to
the associated pipeline execution to review:
- Execution status (Completed, Failed, Running)
- Total execution duration and Snaplex used
- Snap-level statistics (execution time, documents in/out, errors)
- Execution logs with error details and stack traces
Common Issues
| Issue | Indicator | Action |
|---|---|---|
| Authentication failures | 401/403 errors in MCP Metrics | Verify client credentials and policy configuration |
| Timeout errors | Request timeout or Pipeline timeout | Increase timeout settings or optimize Pipeline |
| High latency | Response time > expected threshold | Review Pipeline performance, consider Ultra mode |
| Tool not found | -32601 Method Not Found errors | Verify tool name in request matches Pipeline definition |
| Invalid parameters | -32602 Invalid Params errors | Check parameter types and required fields |
| Pipeline failures | Failed Pipeline executions | Review execution logs for error details |