Developer & Integration

🔧 Developer-Friendly: Clean APIs, standards compliance, and tools for seamless integration and development

🔌 RESTful API & Standards Compliance

What it does: Clean REST API with full MCP protocol compatibility Why you need it: Easy integration with any client, maintain MCP standard compliance How it helps: Well-documented endpoints, standard HTTP methods, consistent responses

API Examples:

# MCP protocol endpoint
POST /mcp
Content-Type: application/json
Authorization: Bearer {token}

# OAuth management dashboard
GET /oauth

# OAuth endpoints (when auth enabled)
POST /oauth/token
GET /oauth/callback/:serverName

⏱️ Setup Time: Ready to use immediately 🎯 Perfect For: Custom integrations, API clients, third-party tools ✅ You Get: Standard REST API, MCP compliance, comprehensive documentation

---

📡 HTTP Transport with MCP Protocol

What it does: Reliable HTTP-based communication using the MCP protocol standard Why you need it: Standards-compliant communication between AI clients and MCP servers How it helps: Request/response patterns, proper error handling, protocol compliance

HTTP MCP Example:

# MCP protocol over HTTP
POST /mcp
Content-Type: application/json
Authorization: Bearer {token}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

⏱️ Setup Time: Built-in, default transport 🎯 Perfect For: Standard MCP client integration, reliable communication ✅ You Get: MCP protocol compliance, reliable transport, standard HTTP methods

Note: SSE transport is deprecated - use HTTP transport instead

---

🧪 Development & Integration Support

What it does: Provides development-friendly features for testing and integration Why you need it: Easier development, debugging, and integration testing How it helps: Hot-reload configuration, structured logging, MCP Inspector support

Development Features:

# Hot-reload configuration changes
npx -y @1mcp/agent --config dev.json
# Edit dev.json → changes applied automatically

# Use MCP Inspector for testing
npx @modelcontextprotocol/inspector
# Connect to http://localhost:3050 for interactive testing

# Environment-specific logging
ONE_MCP_LOG_LEVEL=debug npx -y @1mcp/agent --config dev.json

# Multiple environment configs
npx -y @1mcp/agent --config dev.json --port 3051
npx -y @1mcp/agent --config staging.json --port 3052

⏱️ Setup Time: Built-in development features 🎯 Perfect For: Development workflows, testing, debugging integration issues ✅ You Get: Hot-reload configs, MCP Inspector integration, structured logging, multi-environment support

---

Development Workflows

Integration Testing

• MCP Inspector: Interactive testing interface for debugging
• Health Endpoints: Automated testing of system status
• Request/Response Logging: Detailed debugging information
• Multi-Environment: Separate configs for dev/staging/production

API Integration

• Standard REST: Easy integration with any HTTP client
• Error Handling: Consistent error responses and codes
• Authentication: OAuth 2.1 for secure API access

Debugging and Troubleshooting

• Structured Logging: Winston-based logging with levels
• Request Tracing: Track requests through the system
• Health Diagnostics: Detailed system and server status
• Configuration Validation: Early detection of config issues

Client Libraries

• HTTP Clients: Use any HTTP library (fetch, axios, curl)
• MCP Libraries: Official MCP client libraries
• Real-Time Notifications: Supports receiving real-time updates from servers (e.g., listChanged notifications).
• Custom Integration: Build your own client implementations

Development Best Practices

Configuration Management

• Environment Separation: Different configs for each environment
• Secret Management: Secure handling of sensitive data
• Hot Reload: Fast development iteration cycles
• Validation: Early detection of configuration errors

Testing Strategies

• Unit Testing: Test individual components and functions
• Integration Testing: Test server interactions and workflows
• End-to-End Testing: Full system testing with real MCP servers
• Load Testing: Performance testing under realistic conditions

Monitoring and Observability

• Request Logging: Track all API requests and responses
• Performance Metrics: Monitor response times and throughput
• Error Tracking: Centralized error collection and analysis
• Health Monitoring: Continuous system health verification

Next Steps

• Core Setup → Core Features
• Security Integration → Security Features
• Production Deployment → Enterprise Features

Integration Guides

• Authentication Setup → Authentication Guide
• Configuration Reference → Configuration Guide
• API Documentation → API Reference

---

🔧 Developer Note: These features are designed to make integration and development as smooth as possible. Start with the MCP Inspector for interactive testing, then build your integration using the standard HTTP API.