Skip to main content
MCP servers are the upstream tool providers that your agents interact with through the Devctrl gateway. Register a server to make its tools available in your project.

​
Add from the catalog

  1. Navigate to Tools in your project sidebar
  2. Click Register MCP server
  3. Select a service from the catalog — GitHub, Linear, or Notion
For GitHub and other API-key services, you’ll be asked for your token. The endpoint URL and header format are pre-configured. For Linear, Notion, and other OAuth services, you’ll be redirected to authorize access after registering.

​
Add a custom server

If your MCP server isn’t in the catalog, click Enter a custom URL and provide:
FieldRequiredDescription
Endpoint URLYesThe MCP server’s StreamableHTTP endpoint
HeadersNoAuthentication headers (API keys, tokens)
Devctrl tests the connection and discovers available tools automatically.

​
Authentication methods

Add static headers that the gateway injects into every request to this server.Common patterns:
  • Authorization: Bearer <api-token>
  • X-API-Key: <key>
  • Custom headers required by your tool server
Headers are encrypted at rest. The plaintext is never stored in the database.

​
Tool discovery

After registering a server, Devctrl discovers the tools it exposes. Tools appear in the Tools section of your project. Each tool has:
  • Name — the tool identifier used in MCP tools/call requests
  • Description — what the tool does
  • Input schema — the expected arguments
Tools are automatically synced from the upstream server.

​
Multiple servers

You can register multiple MCP servers in a single project. The gateway routes each tool call to the correct server based on the tool’s registration. 
Project: customer-support
├── jira-server     → get_issue, create_issue, update_issue
├── linear-server   → list_projects, create_issue, add_comment
└── stripe-server   → get_customer, process_refund, list_invoices
Each server can use a different authentication method.

​
Next steps

Manage tools

View and configure the tools discovered from your MCP servers.

Create identities

Create agent identities to authenticate with the gateway.