Debugging Integrations

Overview

Learn how to identify and fix issues with your MCP integrations.

Debugging Tools

MCP Logs

View server request logs

Agent Insights

See tool usage analytics

Playground

Test tools interactively

Accessing Logs

MCP Server Logs

View all requests to your MCP server:

Go to Logs

Dashboard -> MCP Servers -> Your Server -> Logs

Review Requests

See all tool calls:

Timestamp
Tool name
Parameters
Response
Status (success/error)
Duration

Filter

Filter logs by:

Date range
Tool name
Status (success/error)
Agent

Agent Tool Logs

View tools used by specific agent:

Open Agent

Go to your agent

Insights Tab

Click Insights tab

Tool Analytics

See:

Which tools were called
Success/failure rates
Response times
Error messages

Common Issues

Authentication Errors

Symptom: 401 Unauthorized or 403 Forbidden Causes:

Invalid API key
Expired token
Wrong authentication method
Missing credentials

Debug:

Check Credentials

Dashboard -> Agents -> Your Agent -> Tools -> Your ToolVerify:

API key is correct
Auth method matches API requirements
Credentials not expired

Test API Directly

# Test with curl
curl https://api.example.com/users \
  -H "Authorization: Bearer YOUR_TOKEN"

If this fails, the issue is with your credentials

Check Logs

Look for auth errors in MCP server logs

Fix

Update credentials in Agent tool settings and test again

Tool Not Found

Symptom: “Tool not available” error Causes:

Tool not in OpenAPI spec
MCP server not connected to agent
Tool name mismatch

Debug:

Check Connection

Agent -> Tools TabVerify MCP server is connected and showing tools

Check Tool Name

Tool names are generated from endpoint paths:

GET /users -> get_users
POST /customers -> create_customer

Check if expected tool name matches

Refresh

Disconnect and reconnect Agent tool to refresh tools

Slow Responses

Symptom: Tools taking >5 seconds Causes:

Slow API responses
Large data transfers
Network issues
No caching

Debug:

Check Response Times

Dashboard -> MCP Servers -> LogsLook at duration column

Test API Speed

# Time API call
time curl https://api.example.com/users

Identify Slow Endpoints

Find which tools are slowest in logs

Fix

Options:

Optimize API queries
Add caching
Paginate large results
Use async processing

Invalid Parameters

Symptom: “Invalid parameter” or “Required parameter missing” Causes:

Missing required field
Wrong parameter type
Invalid format

Debug:

Check Logs

Look for parameter validation errors

Review OpenAPI Spec

Verify parameter definitions:

parameters:
  - name: email
    required: true
    schema:
      type: string
      format: email

Test in Playground

Try tool with different parameter combinations:

"Create customer John, john@test.com"
vs
"Create customer John"

Fix

Update OpenAPI spec with correct parameter requirements

Rate Limiting

Symptom: 429 Too Many Requests Causes:

Exceeded API rate limits
Too many concurrent requests
No rate limit handling

Debug:

Check Rate Limits

Review API documentation for limits

Monitor Request Volume

Dashboard -> MCP Servers -> AnalyticsCheck requests per minute

Review Logs

Look for 429 errors and their timing

Fix

Options:

Implement exponential backoff
Add request queuing
Cache responses
Upgrade API plan

Debugging Workflow

Step 1: Reproduce

Reproduce the issue consistently:

1. Open Playground
2. Send exact same request
3. Observe error

Example:
"Create customer john@test.com"
-> Error: "Email already exists"

Step 2: Check Logs

Review MCP server logs:

Timestamp: 2025-01-05 10:30:15
Tool: create_customer
Parameters: { email: "john@test.com", name: "John" }
Response: { success: false, error: "Email already exists" }
Status: Error
Duration: 234ms

Step 3: Test Directly

Test the underlying API directly:

# Replicate the exact call
curl -X POST https://api.example.com/customers \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"email": "john@test.com", "name": "John"}'

Step 4: Isolate

Narrow down the issue:

Is it authentication? Test with different credentials
Is it the API? Test API directly
Is it the MCP server? Check other tools
Is it the agent? Test with different agent

Step 5: Fix

Apply the appropriate fix:

Dashboard -> MCP Servers -> Settings
-> Update API credentials

Contact API provider or
review API documentation

Dashboard -> MCP Servers -> Edit
-> Update OpenAPI spec

Agent -> Settings -> Reset
-> Reconnect tools

Step 6: Verify

Test the fix:

Apply fix
Test in Playground
Check logs for success
Monitor for 24 hours

Advanced Debugging

Enable Verbose Logging

Get more detailed logs: Dashboard -> MCP Servers -> Your Server -> Settings

Enable Debug Mode
Shows full request/response bodies
Includes headers and metadata

Webhook Debugging

For webhooks, test delivery:

# Use webhook.site for testing
Go to webhook.site
Copy unique URL
Set as webhook URL in MCP server
Trigger event
See exact payload received

Network Debugging

Check network issues:

# Test connectivity
ping api.example.com

# Check DNS
nslookup api.example.com

# Trace route
traceroute api.example.com

# Test SSL
openssl s_client -connect api.example.com:443

Debugging Checklist

When debugging an issue:

Getting Help

If you’re still stuck:

Check Documentation

Contact Support

hello@boostgpt.co Include:

MCP server ID
Error message
Steps to reproduce
Logs (from Dashboard -> MCP Servers -> Logs)
OpenAPI spec or Postman collection

Community

Join our Discord for community help:

discord.gg/boostgpt

Next Steps

Testing Guide

Learn how to test integrations

Best Practices

Follow integration best practices

Getting Started

Choose Your Path

Providers & Models

Overview

Debugging Tools

MCP Logs

Agent Insights

Playground

Accessing Logs

MCP Server Logs

Agent Tool Logs

Common Issues

Authentication Errors

Tool Not Found

Slow Responses

Invalid Parameters

Rate Limiting

Debugging Workflow

Step 1: Reproduce

Step 2: Check Logs

Step 3: Test Directly

Step 4: Isolate

Step 5: Fix

Step 6: Verify

Advanced Debugging

Enable Verbose Logging

Webhook Debugging

Network Debugging

Debugging Checklist

Getting Help

Check Documentation

Contact Support

Community

Next Steps

Testing Guide

Best Practices

​Overview

​Debugging Tools

MCP Logs

Agent Insights

Playground

​Accessing Logs

​MCP Server Logs

​Agent Tool Logs

​Common Issues

​Authentication Errors

​Tool Not Found

​Slow Responses

​Invalid Parameters

​Rate Limiting

​Debugging Workflow

​Step 1: Reproduce

​Step 2: Check Logs

​Step 3: Test Directly

​Step 4: Isolate

​Step 5: Fix

​Step 6: Verify

​Advanced Debugging

​Enable Verbose Logging

​Webhook Debugging

​Network Debugging

​Debugging Checklist

​Getting Help

​Check Documentation

​Contact Support

​Community

​Next Steps

Testing Guide

Best Practices

Overview

Debugging Tools

Accessing Logs

MCP Server Logs

Agent Tool Logs

Common Issues

Authentication Errors

Tool Not Found

Slow Responses

Invalid Parameters

Rate Limiting

Debugging Workflow

Step 1: Reproduce

Step 2: Check Logs

Step 3: Test Directly

Step 4: Isolate

Step 5: Fix

Step 6: Verify

Advanced Debugging

Enable Verbose Logging

Webhook Debugging

Network Debugging

Debugging Checklist

Getting Help

Check Documentation

Contact Support

Community

Next Steps