> ## 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.

# How to Add a Connection

> Connect standard and custom connections to Duvo, and manage connection credentials.

## Standard Connections

The **Available Connections** tab displays the standard connections supported by Duvo. Each connection card provides details on the connection's capabilities.

<Steps>
  <Step title="Click Connect on the desired connection" icon="plug">
    Click "Connect" on the desired connection.

    <Frame>
      <img src="https://mintcdn.com/duvo-d8027998/vP3-0V6Q0VBvZeLx/images/user-guide/resources/how-to-connect-integration-1.png?fit=max&auto=format&n=vP3-0V6Q0VBvZeLx&q=85&s=3ead0078ba3cbd90cde70f73f82fc2e1" alt="Click Connect on the connection card" width="1396" height="1158" data-path="images/user-guide/resources/how-to-connect-integration-1.png" />
    </Frame>
  </Step>

  <Step title="Complete authentication" icon="key">
    Complete the authentication steps for the application you're connecting to.

    The connection will appear in the "My Connections" tab making its tools available to your agents.
  </Step>
</Steps>

## Custom Connections

These can be connected to Duvo in the "Available Connections" tab:

<Steps>
  <Step title="Add Custom MCP" icon="plus">
    Click "+ Add Custom MCP" button.

    <Frame>
      <img src="https://mintcdn.com/duvo-d8027998/vP3-0V6Q0VBvZeLx/images/user-guide/resources/how-to-connect-integration-2.png?fit=max&auto=format&n=vP3-0V6Q0VBvZeLx&q=85&s=45cb93e1638338885bed2555f36f563d" alt="Add Custom MCP" width="996" height="1184" data-path="images/user-guide/resources/how-to-connect-integration-2.png" />
    </Frame>
  </Step>

  <Step title="Name" icon="tag">
    **Name**: Choose a descriptive name that identifies what system the connection is supporting.
  </Step>

  <Step title="MCP URL" icon="link">
    **MCP URL**: Enter the web address where your MCP server is hosted (e.g., `https://mcp.yourcompany.com/mcp`).
  </Step>

  <Step title="Authorization" icon="lock">
    **Authorization**: Choose how Duvo should authenticate:

    * None: No authentication required
    * API Key: Provide an API key for authentication
    * OAuth: Use OAuth flow for authentication. Duvo automatically detects whether the MCP server supports **dynamic client registration (DCR)**. If it does, no Client ID or Secret is needed — the connection is handled automatically. If the server does not support DCR, or if you prefer to use your own pre-registered OAuth app, you can provide a Client ID and Client Secret in the **Advanced settings** section.
  </Step>

  <Step title="Save" icon="save">
    Click "Save".

    Once configured, the custom connection will appear in your "My Connections" tab, making its tools available to your agents.
  </Step>
</Steps>

## Reconnecting a Broken Connection

An OAuth connection stops working when its authorization is revoked or expires at the provider. Duvo marks the connection as broken and shows a **Reconnect needed** badge next to it in "My Connections", plus a red accent on the connection pill in the Agent builder.

Click **Reconnect** on the badged connection. Duvo sends you back to the provider's consent screen and updates the same connection in place, so every Agent that uses it keeps working. Deleting the connection and adding it again would unlink it from those Agents.

<Note>
  You reconnect your own personal connection. For a connection shared with the team, the member who shared it reconnects it at Manager and above; anyone else needs Administrator, because reconnecting replaces the stored credential with your own account.
</Note>

<Warning>
  A missing badge does not always mean the connection is healthy. Duvo detects breakage when it refreshes the stored token, so an authorization revoked at the provider can stay unflagged until the next refresh. A Run that fails as if a system went missing can still be an access problem, even with no badge on the connection.
</Warning>

## Editing Connection Credentials

To update a connection's credentials, open the connection from your "My Connections" tab and click **Edit**.

Sensitive fields such as API keys, passwords, and service account credentials are write-only. When you open an existing connection to edit it, these fields will appear empty — the stored credentials are not displayed for security reasons. Leave a field empty to keep the existing value, or enter a new value to replace it.


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