Agent - Custom MCP

Agent - Custom MCP

Overview

Custom MCP Source allows user to connect to any remotely hosted MCP servers and use it during chatting. If you want to learn more about MCP visit https://modelcontextprotocol.io/docs/learn/architecture

Configuration

  1. Navigate to System Settings > Sources and press Add

  2. Fill in Title

  3. Fill in Description (optional)

  4. Choose Custom MCP as a source

  5. Fill in the URL with the full URL to the MCP server. For example https://mcp.tavily.com/mcp

  6. Choose the authorization type in Type field and provide required details.

Configure Authorization

If the server is publicly open, meaning you do not need to authorize to use it, then choose None as a Type

API Key

  1. If the server is configured to accept API key, then choose API Key as a Type.

  2. Provide the API key value

  3. Provide Location of the API key.

    1. API Key in Header

      1. Choose Header as a Key location

      2. Fill in Key name. If the server accepts a header in form x-api-key=api_key_value Key name will be x-api-key.

    2. API Key in Query

      1. Choose Query as a Key location

      2. Fill in Key name. If servers accepts API key as query parameter in form x-api-key=api_key_value for example https://mcp.server.com?x-api-key=api_key_value then Key location

If servers accepts API key as query parameter in form x-api-key=api_key_value for example https://mcp.server.com?x-api-key=api_key_value then Key location will be Query and Key name will be x-api-key.

OAuth

If the server is configured to use OAuth, then choose OAuth as type. Server needs to meet standards described here https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization

If the server supports dynamic client registration, then you can leave Client ID and Client Secret empty. If not, then Client ID needs to be provided and Client Secret if required.