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

# Connect Claude Desktop

> Add Agent Vault to Claude Desktop or claude.ai as a custom connector and sign in, in about 3 minutes.

Connect Claude Desktop, or Claude on the web, to Agent Vault so it can check out
and sign in for you, using only mock tokens. It takes about 3 minutes in the
app's settings. Claude can't add a connector from a chat, so there is no line to
paste.

<Frame caption="Pick Claude Desktop on your dashboard to get the connector URL and the steps.">
  <video controls muted playsInline preload="metadata" className="w-full" poster="/images/agents/claude-desktop-poster.webp" src="https://mintcdn.com/self-labs/VeDWRFlNWGO5jQN6/videos/agents/claude-desktop.mp4?fit=max&auto=format&n=VeDWRFlNWGO5jQN6&q=85&s=82783b913e200579d727e6e78e8a7eba" aria-label="The dashboard's Connect another agent panel with Claude Desktop picked, showing the connector steps and the URL to enter." data-path="videos/agents/claude-desktop.mp4" />
</Frame>

## Before you start

* An Agent Vault account, with a card if your agent will check out. New here?
  The [Quickstart](/get-started/quickstart) sets one up in about 5 minutes.
* Claude Desktop or claude.ai. On a Team or Enterprise plan, someone who can
  manage connectors adds it first: see [On a Team or Enterprise plan](#on-a-team-or-enterprise-plan).

## Add the connector

<Steps>
  <Step title="Open Connectors">
    In Claude Desktop, open **Settings → Connectors**. On claude.ai, open
    **Customize → Connectors**.
  </Step>

  <Step title="Add a custom connector">
    Press **+ Add**, then **Add custom connector**. Name it **Agent Vault**, enter
    this URL and press **Continue**:

    ```text theme={null}
    https://mcp.agentvault.io/mcp
    ```
  </Step>

  <Step title="Keep the detected sign-in settings">
    Claude shows the sign-in settings it detected. Press **Continue** again.
  </Step>

  <Step title="Choose how it signs in">
    Choose **Sign in now**, and keep **Use Claude's published identity**, or choose
    **Register automatically**. Don't choose **Use your own OAuth client**: no
    client ID or secret is needed. Press **Add**.
  </Step>
</Steps>

## Sign in

<Steps>
  <Step title="Connect">
    Next to **Agent Vault** in your Connectors list, click **Connect**. Sign in on
    the Agent Vault sign-in page that opens, with your Agent Vault account.
  </Step>

  <Step title="Turn it on in your chat">
    In a chat, click **+**, open **Connectors** and turn **Agent Vault** on.
    Connectors are off in each chat until you turn them on.
  </Step>
</Steps>

## Choose what it may use

A new connection starts with nothing granted, so your agent can't use a card or
a login yet. Until you choose, its first tool call answers:

```text theme={null}
Choose what this app may use in Agent Vault before it can act: open the connection's page in the dashboard.
```

The connection itself appears in the dashboard only once your agent makes its
first tool call, so make that call first.

<Steps>
  <Step title="Make a first call">
    Ask your agent to call `get_token_catalog`. It answers with the message above,
    and the call creates the connection.
  </Step>

  <Step title="Open Connected apps">
    In the dashboard sidebar, under **Vault**, click **Connected apps**. The new
    connection's row shows **Choose what it may use**.
  </Step>

  <Step title="Pick its cards and logins">
    Click **Choose access**. Under **Cards** and **Logins**, pick **All**, or keep
    **Only selected** and tick the ones this agent may use.
  </Step>

  <Step title="Check the choices, then click Save access">
    Your first connection's dialog opens with nothing ticked. After that, a new
    connection's dialog opens with the choices of the connection you used most
    recently, so saving it unchanged grants the same cards and logins, and the same
    three switches: **Let this app create and change its own logins**, **Ask me
    before every purchase from this app** and **Fill a test card instead of my
    card**. Check all of them for this agent before you click **Save access**.
  </Step>
</Steps>

You can change or revoke the connection on the same page at any time. See
[Connected apps](/dashboard/api-keys#connected-apps).

## Check it works

In a chat with **Agent Vault** turned on, ask Claude to call the Agent Vault
tool `get_token_catalog`. It answers with the mock tokens for the cards and
logins you allowed, such as `av_card_1_number_u7x2k`. Your real card number
never reaches the chat.

## On a Team or Enterprise plan

On a Team plan only an owner can add a custom connector. On an Enterprise plan,
an owner or someone whose role includes managing access to Libraries can. Ask
them to add it under **Organization settings → Connectors** (**Add**, then
**Custom**, then **Web**), with the same URL and the same sign-in choices. You
then find **Agent Vault** in your Connectors list and connect it as above.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Claude asks for a client ID and secret">
    You chose **Use your own OAuth client**. Remove the connector and add it again
    with **Use Claude's published identity** or **Register automatically**.
  </Accordion>

  <Accordion title="Claude doesn't see the Agent Vault tools">
    Connectors are off in each chat until you turn them on. Click **+**, open
    **Connectors** and turn **Agent Vault** on.
  </Accordion>

  <Accordion title="The first tool call says to choose what this app may use">
    The connection has nothing granted yet. Follow
    [Choose what it may use](#choose-what-it-may-use), then ask again.
  </Accordion>
</AccordionGroup>

## Next

<CardGroup cols={2}>
  <Card title="Your first checkout" icon="cart-shopping" href="/guides/first-checkout">
    Have Claude buy something, start to finish.
  </Card>

  <Card title="Connect Claude Code" icon="https://mintcdn.com/self-labs/VeDWRFlNWGO5jQN6/logo/agents/claude.svg?fit=max&auto=format&n=VeDWRFlNWGO5jQN6&q=85&s=92b3e2417d163fe828f78e0446b3d4f7" href="/agents/claude-code" width="96" height="96" data-path="logo/agents/claude.svg">
    Use Agent Vault from Claude Code too.
  </Card>
</CardGroup>


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