> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect a custom MCP to Duvo

> Bring your own MCP server into Duvo as a Connection. Let agents call tools from internal systems, legacy platforms, or custom APIs alongside built-in connections.

To connect an MCP server to Duvo, add it as a **Custom MCP Connection**. Your Duvo Agents can then call its tools from an MCP server you host — use this when a built-in Connection doesn't cover the system you need (internal tools, legacy platforms, custom-built APIs) and you'd rather expose those tools via MCP than build a one-off integration.

To Duvo, a Custom MCP Connection looks like any other Connection. Your Agent's Setup picks tools from your MCP server alongside tools from Gmail, Slack, or Snowflake.

If you haven't built the server yet, see [Build an MCP server for Duvo](/mcp/building-mcp-servers) first. If instead you want to drive Duvo from an MCP host, see [The Duvo MCP server](/mcp/duvo-mcp-server).

## When to use a Custom MCP Connection

* You have a proprietary internal system (CRM, warehouse API, internal tool) that isn't a built-in Duvo Connection.
* You've already built or can build an MCP server for that system.
* You want consistent setup across teammates — add the Connection once, every teammate can connect with their own credentials.

If you want to drive Duvo from an MCP host instead, see [The Duvo MCP server](/mcp/duvo-mcp-server).

## What you need to bring

* **A deployed MCP server** accessible over the internet via a public HTTPS URL. Localhost is not supported.
* **Streamable HTTP transport.** Servers that only support STDIO or HTTP/SSE cannot connect.
* **Your authentication method** — Custom MCP supports no-auth, API key, custom HTTP headers, and OAuth (with automatic Dynamic Client Registration where available).

## Setup at a glance

Full step-by-step instructions live on the Custom MCP Connection page: [Custom MCP](/user-guide/connections/available-connections/custom-mcp).

The short version:

<Steps>
  <Step title="Add a custom connection" icon="plus">
    Open the [Connections page](https://app.duvo.ai/integrations) in Duvo and click **Add custom connection**.
  </Step>

  <Step title="Name the Connection" icon="tag">
    Give the Connection a recognizable name (for example, "Internal CRM").
  </Step>

  <Step title="Pick an authorization method" icon="shield">
    Pick an authorization method (None, API key, custom headers, or OAuth).
  </Step>

  <Step title="Enter the server URL" icon="link">
    Enter your server's public HTTPS URL.
  </Step>

  <Step title="Create the Connection" icon="circle-check">
    Click **Create**. Teammates then sign into the Connection individually with their own credentials.
  </Step>
</Steps>

## OAuth support

If your MCP server uses OAuth, Duvo automatically detects whether it supports **Dynamic Client Registration (DCR, [RFC 7591](https://datatracker.ietf.org/doc/html/rfc7591))**:

* **DCR-capable servers** — Duvo registers itself automatically. No Client ID or Secret required.
* **Servers without DCR** — Provide your own Client ID and Client Secret in the **Advanced settings** when setting up the Connection. Duvo displays the redirect URI you need to register on your OAuth provider.

You can also force the manual path if you'd rather use a pre-registered OAuth app instead of auto-registration.

## Related

<CardGroup cols={2}>
  <Card title="Custom MCP connection page" icon="book" href="/user-guide/connections/available-connections/custom-mcp">
    The detailed setup walkthrough with every field and option
  </Card>

  <Card title="Building an MCP server for Duvo" icon="hammer" href="/mcp/building-mcp-servers">
    What to consider when implementing the server itself
  </Card>

  <Card title="Duvo MCP server" icon="server" href="/mcp/duvo-mcp-server">
    The other direction: connect MCP hosts to Duvo
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.