Skip to main content
Servers are the MCP integrations that provide tools to your agents. Caylex supports two ways to add servers: from the Caylex Catalog of pre-configured servers, or as custom servers that you manage.

​
Add a server from the Caylex Catalog

The Caylex Catalog contains pre-configured MCP servers for popular platforms. These servers come with pre-defined endpoints, transport settings, and authentication methods — so you can add them with minimal configuration.
1

Browse the catalog

Navigate to the Servers page and click Add Server. Browse the catalog by category or search for a specific platform (e.g., GitHub, Slack, Linear, Notion, Gmail).
2

Select a server

Click on the server you want to add. Review the server details including available tools, authentication method, and description.
3

Add to your tenant

Click Add Server to add it to your organization. The server is now available to connect to any of your projects.

​
Add a custom server

If the server you need is not in the catalog, you can add your own MCP server by providing its connection details.
1

Choose your auth method

Navigate to Servers and click Add Server, then select Custom Server. Choose the authentication method your server uses:
  • OAuth — for servers that use OAuth 2.0 (e.g., Google APIs, Microsoft Graph)
  • Header — for servers that authenticate via HTTP headers (e.g., API keys, Bearer tokens)
  • Path — for servers that embed credentials in the URL path
  • Query — for servers that pass credentials as URL query parameters
  • No Auth — for servers that do not require authentication
2

Configure the server

Provide the connection details:
  • Name — a unique name for the server
  • Endpoint URL — the MCP server’s endpoint
  • Transport type — Streamable HTTP (recommended) or SSE
  • Auth configuration — specific to the auth method you selected (see below)
3

Save and verify

Save the server. Caylex automatically discovers the available tools from the server endpoint and registers them.
Your custom server appears in the servers list, ready to be connected to projects.

​
Auth method details

Caylex automates most of the OAuth setup for you:
  1. Enter your MCP server’s endpoint URL
  2. Click Discover OAuth — Caylex automatically discovers the server’s OAuth metadata (authorization endpoint, token endpoint, supported scopes) using standard protocols (RFC 9728, RFC 8414, OIDC Discovery)
  3. If the server supports Dynamic Client Registration (DCR), Caylex automatically registers an OAuth client — no credentials needed from you
  4. If DCR is not available, you are prompted to provide a Client ID and Client Secret manually
For catalog servers, OAuth credentials are pre-configured — no discovery or manual setup required.
Most catalog servers have OAuth fully pre-configured. For custom servers, Caylex tries automatic discovery and registration first, and only asks for manual credentials as a fallback.
Define the HTTP headers your server requires:
  • Header name (e.g., X-API-Key, Authorization)
  • Value prefix (optional, e.g., Bearer for Authorization headers)
Users provide their header values when authenticating via an auth link. Values are stored securely in AWS Parameter Store.
Define the URL path parameters your server requires:
  • Use <PARAM_NAME> or {PARAM_NAME} placeholders in your endpoint URL
  • List each parameter that users need to provide
Example endpoint: https://api.example.com/<workspace_id>/mcp
Define the query parameters your server requires:
  • Parameter name (e.g., api_key)
  • Users provide parameter values when authenticating
Values are appended to the endpoint URL at runtime.
No authentication configuration needed. The server is accessible without credentials.

​
Connect a server to a project

After adding a server to your organization, connect it to a project to create a Server Instance.
1

Go to your project

Navigate to the project where you want to add the server.
2

Add a server instance

Click Add Server on the project page and select the server you want to connect. This creates a Server Instance — a project-scoped deployment of that server.
3

Configure authentication

If the server requires authentication, set up an Auth Link so that users (or a service account) can provide credentials for this project.

​
Pause and unpause server instances

You can temporarily disable a Server Instance by pausing it. When paused:
  • The server’s tools are not exposed to agents in that project
  • Existing credentials are preserved
  • You can unpause at any time to restore access
This is useful for maintenance windows or temporarily restricting access to certain integrations.

​
Build a server from an API spec

If you have an API that is not available as an MCP server, you can use Server Foundry to generate one from an OpenAPI specification. The AI-powered Designer Agent guides you through selecting endpoints, optimizing tool definitions, and deploying a production-ready MCP server.

Server Foundry

Learn how to build custom MCP servers from any OpenAPI spec.