Connection Overview¶
EcoSemantic supports multiple ways to connect AI chat applications to our MCP server. Choose the method that best fits your use case.
Available Connection Methods¶
🔐 OAuth 2.1 (Recommended)¶
Best for: Secure, user-authorized connections with automatic token management.
- ✅ Most secure authentication method
- ✅ No manual token management required
- ✅ Automatic token refresh
- ✅ Granular permission scopes
- ✅ Easy to revoke access
Supported Clients: - Claude Desktop (via MCP) - OpenAI Chat (coming soon) - Custom MCP clients
🔑 API Token¶
Best for: Direct API access, automation, and development.
- ✅ Simple setup process
- ✅ Works with any MCP client
- ✅ Good for testing and development
- ✅ Long-lived tokens available
- ⚠️ Requires manual token management
Supported Clients: - Claude Desktop - Any MCP-compatible client - Custom integrations
Comparison Table¶
| Feature | OAuth 2.1 | API Token |
|---|---|---|
| Security | High | Medium |
| Setup Complexity | Medium | Easy |
| Token Management | Automatic | Manual |
| Token Refresh | Automatic | Manual regeneration |
| Revocation | Instant | Immediate |
| Best For | Production | Development |
Choosing a Method¶
Use OAuth 2.1 if:¶
- You're deploying to production
- You need automatic token management
- You want the highest security
- Users should authorize access themselves
Use API Token if:¶
- You're in development/testing
- You need quick setup
- You're building automation scripts
- You're comfortable managing tokens manually
Next Steps¶
Choose your connection method: - OAuth 2.1 Setup → - API Token Setup → - Claude Desktop Integration → - Client Compatibility → - Check if your MCP client is supported