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.
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
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.
Create the connector
Create a new connector. Paste https://mcp.spicrawl.com/chatgpt/mcp as its address and set authentication to OAuth.
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).
Allow access
Read the permissions on the consent screen (see Permissions), then click Allow. You are sent back to ChatGPT, and the connector shows as connected.
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.
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). 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, 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, or wait for the monthly reset. See Errors. |
ERR::UPSTREAM::CHALLENGE | The site blocked the fetch. | Nothing is charged (0 credits). See Errors. |
MCP server
Connect any MCP client to the hosted Spicrawl MCP server at https://mcp.spicrawl.com/mcp and use its spicrawl_* tools to scrape, batch, manage sessions, inspect usage and search the docs.
Smithery
Add the Spicrawl MCP server from Smithery (spicrawl/web-scraper) with the Smithery CLI or website, send your API key as the x-api-key header, and use all 24 spicrawl_* tools.