# Chat assistants (/docs/connect/assistants)

In Claude, add quarry with the free address:

```text
https://quarry.market/api/mcp
```

Claude searches quarry right away, with no account, and asks you to connect your
quarry account the first time it needs it, for example to use a subscription. One
connector covers everything, which matters on plans that allow only one.

In ChatGPT, add the sign-in address instead, `https://quarry.market/api/agent/mcp`:
ChatGPT asks you to sign in to quarry (or create an account) when you add it.

Once connected, the assistant shows up under **Connected agents** on your
[Subscriptions](/subscriptions) page, where **Revoke** disconnects it. A connected
account also gets its own search limits instead of sharing them with everyone who
uses that assistant signed out.

Your assistant uses free datasets and your subscriptions: see
[How paying works](/docs/paying). In the desktop app, Claude can also pay per question
with a wallet of its own: see [Give your assistant a wallet](/docs/wallet).

## Claude [#claude]

In Claude on the web or in the desktop app:

1. Click [Add quarry to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector\&connectorName=quarry\&connectorUrl=https%3A%2F%2Fquarry.market%2Fapi%2Fmcp).
   Claude opens its Add custom connector window with quarry's name and address
   filled in: check them and click Continue.
2. Under Authentication, choose Sign in when needed, leave the other settings as
   they are, and click Add.
3. In a chat, turn quarry on from the + button at the bottom left, under
   Connectors.
4. The first time Claude needs your quarry account, for example to use a
   subscription, it shows Authorization required above the message box. Click
   Reconnect, sign in to quarry (or create an account), and click
   **Connect agent**. Then ask your question again.

Without the link, open Customize → Connectors, click +, then Add custom connector,
and paste the address. quarry then works in Claude on the web, in the desktop and
mobile apps, and in Claude Code when you sign in to it with the same Claude account.

On the Free plan, you can add one custom connector. On Team and Enterprise plans, an
owner adds quarry for everyone with
[the organization link](https://claude.ai/admin-settings/connectors?modal=add-custom-connector\&connectorName=quarry\&connectorUrl=https%3A%2F%2Fquarry.market%2Fapi%2Fmcp),
or under Organization settings → Connectors → Add → Custom → Web, with the address.
Each member then finds it in Customize → Connectors, marked Custom, and
connects their own quarry account when Claude asks. To share your organization's
subscriptions, see [Share with your team](/docs/subscriptions#teams).

## ChatGPT [#chatgpt]

Custom connectors need Developer mode, available on the Plus, Pro, Business,
Enterprise, and Education plans, on the web. In a Business workspace, only admins
and owners can create the app: ask one to follow these steps, then connect with
your own sign-in.

1. Open Settings → Security and login and turn on Developer mode.
2. Go to Plugins, select +, and create a developer-mode app with the sign-in
   address.
3. For authentication, choose OAuth. When ChatGPT asks, sign in to quarry and click
   **Connect agent**.

The new app is listed under Drafts in the app settings, where you can turn its
tools on or off. With the free address, choose No Authentication instead.

## Other assistants [#other-assistants]

Perplexity and Mistral Le Chat can add quarry's free address, to search quarry and
read free datasets. We haven't confirmed that their sign-in works with quarry
accounts yet, so use Claude or ChatGPT for your subscriptions.

* Perplexity (Pro, Max, and Enterprise): Account settings → Connectors → Custom
  connector → Remote. Enter the name and the free address, set Authentication to
  None and Transport to Streamable HTTP.
* Mistral Le Chat: Connectors → Add Connector → Custom MCP Connector. Enter the
  name and the free address, then click Connect. Only an admin can add connectors;
  on the Free, Pro, and Student plans, that's the account owner.

## If something goes wrong [#if-something-goes-wrong]

* Claude hasn't asked you to sign in: it asks only when it needs your quarry
  account. To connect it now, ask Claude how many questions you have left on your
  quarry subscriptions. If it still doesn't ask, quarry was added with No sign-in:
  remove it in Customize → Connectors and add it again with Sign in when needed.
* ChatGPT didn't ask you to sign in when you added quarry: you added the free
  address. Remove quarry and add the sign-in address instead.
* A paid dataset says it needs a subscription, or asks for a USDC payment: your
  quarry account isn't connected yet, you don't subscribe to that dataset, or you've
  used this month's questions (check **Your subscriptions** on the
  [Subscriptions](/subscriptions) page). Subscribe on the dataset's public page, or
  ask the assistant to prepare the Checkout link for you: see
  [Subscriptions and API keys](/docs/subscriptions).
* quarry says no passage answers the question: nothing was charged, and no question
  was used. Rephrase it, or try another dataset.
* quarry says you're asking too often: wait a minute. Searches are also limited per
  day. Signed out, that daily limit is shared with everyone else using the same
  assistant signed out; once your quarry account is connected, it counts only your
  own searches.