# ChatGPT

> Connect ChatGPT to Spicrawl at https://mcp.spicrawl.com/chatgpt/mcp with OAuth: log in, allow access, and ChatGPT gets the scrape and batch tools. No API key to paste.

Source: https://docs.spicrawl.com/agents/chatgpt

ChatGPT connects to Spicrawl with OAuth. You log in, allow access, and ChatGPT calls Spicrawl's tools under that account. There is no API key to paste.

## Address

| Address                                | Sign-in                                           | For                                                |
| -------------------------------------- | ------------------------------------------------- | -------------------------------------------------- |
| `https://mcp.spicrawl.com/mcp`         | API key (`Authorization: Bearer spicrawl_live_…`) | Claude Code, Cursor, the CLI and other MCP clients |
| `https://mcp.spicrawl.com/chatgpt/mcp` | Log in to Spicrawl (OAuth), no key to paste       | ChatGPT                                            |

Use the one for your client; the other refuses the wrong kind of sign-in. For ChatGPT, use `https://mcp.spicrawl.com/chatgpt/mcp` and nothing else.

## Connect ChatGPT

**Step 1: Turn on developer mode**

In ChatGPT's settings, under **Apps & Connectors**, open the advanced settings and turn on **Developer mode**. ChatGPT's menu names change, so look for the section by name.

**Step 2: Create the connector**

Create a new connector. Paste `https://mcp.spicrawl.com/chatgpt/mcp` as its address and set authentication to **OAuth**.

**Step 3: Log in**

ChatGPT sends you to `app.spicrawl.com`. Log in to Spicrawl. If your account has more than one workspace, choose the workspace to use. Its credits pay for the calls (see [Billing](#billing)).

**Step 4: Allow access**

Read the permissions on the consent screen (see [Permissions](#permissions)), then click **Allow**. You are sent back to ChatGPT, and the connector shows as connected.

**Step 5: Try it**

Ask ChatGPT:

```text
Use Spicrawl to scrape https://example.com
```

## Permissions

The consent screen lists the permissions the connector asks for. Allow only what you want ChatGPT to use.

| Permission | Shown as        | Tools it unlocks                                                           |
| ---------- | --------------- | -------------------------------------------------------------------------- |
| `scrape`   | Fetch web pages | `spicrawl_scrape`                                                          |
| `batch`    | Run batch jobs  | `spicrawl_batch_submit`, `spicrawl_batch_status`, `spicrawl_batch_results` |

The docs tools need no permission: `spicrawl_docs_search` and `spicrawl_docs_read` read the public docs.

The other tools on `/mcp`, such as sessions, screenshots and usage, are not on the ChatGPT address. To use them, connect with an API key as described on [MCP server](https://docs.spicrawl.com/agents/mcp.md).

## Billing

Allowing access creates a dedicated API key named `ChatGPT (OAuth)` in the workspace you chose. Every call ChatGPT makes is billed to that workspace's credits, at the same prices as the API (see [Credits](https://docs.spicrawl.com/credits.md)). The key appears in usage and in the request log, like any other key.

## Disconnect or revoke

Either of these stops ChatGPT's access:

* In ChatGPT's settings, disconnect the Spicrawl connector.
* On [app.spicrawl.com](https://app.spicrawl.com), go to **Settings → Connected apps** and click **Revoke**.

Revoking deletes the grant and its `ChatGPT (OAuth)` key, so access stops immediately. The next time ChatGPT uses the connector, it asks you to log in again.

## Errors

| What you see                                                                                                | Cause                                          | What to do                                                                                                     |
| ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| ChatGPT shows the connector as needing to connect again. The server answers `401` with a sign-in challenge. | Your session expired.                          | Reconnect and log in.                                                                                          |
| The same message as above.                                                                                  | Access was revoked.                            | Reconnect and click **Allow** again.                                                                           |
| A tool call asks for a permission you did not grant (`scrape` or `batch`).                                  | The grant lacks that permission.               | Reconnect and allow the permission.                                                                            |
| `ERR::LIMIT::QUOTA_EXCEEDED` (HTTP 402)                                                                     | The workspace is out of credits for the month. | Add credits on [Credits](https://docs.spicrawl.com/credits.md), or wait for the monthly reset. See [Errors](https://docs.spicrawl.com/errors.md#LIMIT_QUOTA_EXCEEDED). |
| `ERR::UPSTREAM::CHALLENGE`                                                                                  | The site blocked the fetch.                    | Nothing is charged (0 credits). See [Errors](https://docs.spicrawl.com/errors.md#UPSTREAM_CHALLENGE).                                      |