Overview
The CelerFlow MCP Gateway is a standalone service that federates multiple MCP servers behind a single endpoint. Any agent framework with MCP client support can connect — no plugin installation needed.Architecture
The gateway is deployed on Railway as a stateless Node.js/TypeScript service. All state lives in Supabase, so the gateway scales horizontally.Setup
Create an API key
Go to Settings → API Keys in the dashboard. Create a key and copy it immediately — it’s only shown once.
Register your MCP servers
In Settings → MCP Servers, register the backend MCP servers you want to expose through the gateway (e.g., Gmail MCP Server, Notion MCP Server).
Supported frameworks
| Framework | MCP support | Integration |
|---|---|---|
| LangGraph | ✅ Native MCP client | Point to gateway.celerflow.ai |
| CrewAI | ✅ crewai-tools[mcp] | Point to gateway.celerflow.ai |
| Strands (AWS) | ✅ Built on MCP | Point to gateway.celerflow.ai |
| OpenAI Agents SDK | ✅ MCP server support | Point to gateway.celerflow.ai |
| Mastra | ✅ Native MCP | Point to gateway.celerflow.ai |
Framework examples
- LangGraph
- CrewAI
- OpenAI Agents SDK
Gateway vs proxy
CelerFlow’s MCP Gateway is not a simple proxy. It’s a federation layer:| Feature | Simple proxy | CelerFlow Gateway |
|---|---|---|
| Routes to | One upstream server | Multiple registered MCP servers |
| Tool discovery | Pass-through | Aggregated from all servers |
| Policy checks | ❌ | ✅ Service-level permissions |
| HITL | ❌ | ✅ Human approval flow |
| Tracing | ❌ | ✅ Full trace recording |
| Protocol | Varies | Streamable HTTP (MCP 2025-03 standard) |
Limitations
- Only captures MCP protocol tool calls. Built-in tools (e.g., Claude Code’s
file_edit) are not intercepted. - HITL confirmations work but require an approval channel (see Human approval).
- Token usage data requires the agent framework to report it via metadata headers (optional).
Rate limits
| Plan | Requests/min |
|---|---|
| Pro | 100 |
| Team | 500 |
| Enterprise | 2,000 |