--- updatedAt: 2026-07-21T20:30:38.000Z agentTools: projectIndex: https://docs.conveyor.com/llms.txt --- # Connecting Your AI Client **Time to complete:** 2–5 minutes **Prerequisites:** A Conveyor account. For API token authentication, a [Conveyor API token](https://docs.conveyor.com/reference/api-token). *** ## Overview This page walks through connecting your AI client to the [Conveyor AI Connector](ai-connector). Pick the option that matches your client: OAuth for Claude, ChatGPT, and other modern MCP clients; API token for Bearer-capable clients; or JSON configuration for clients like Cursor and Claude Code. Every option points at the same server URL: ``` https://mcp.conveyor.com/mcp ``` > 📘 Enterprise accounts > > Some AI providers (ChatGPT Business, Claude Enterprise, etc.) require an organization admin to register custom connectors before individual users can use them. If Conveyor doesn't appear in your connector list after following these steps, ask your IT admin to add it once for the whole organization. *** ## Option 1 — OAuth (Claude, ChatGPT, Any Modern MCP Client) For OAuth-capable clients, add the server URL as a custom connector or app. The client handles the rest of the flow — you'll log in to Conveyor in the browser and pick which organization to authorize. [block:image] { "images": [ { "image": [ "https://files.readme.io/dd86fab24a4c10e43d24886b1d7570e4e8371b1af452df4bbd3e041f987a40b2-Screenshot_2026-05-26_at_13.41.36.png", "Claude Desktop custom connector dialog with the Conveyor AI Connector server URL entered in the remote server field.", "Adding the Conveyor AI Connector to Claude Desktop as a custom connector." ], "align": "center", "border": true } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/51cb2ad5ab0287a6c4e84d997444bb29ed4994209a23321ca123c05c6bb5adb5-Screenshot_2026-05-26_at_13.50.12.png", "ChatGPT Business settings showing the Conveyor AI Connector server URL added as a custom app.", "Adding the Conveyor AI Connector to ChatGPT Business as a custom app." ], "align": "center", "border": true } ] } [/block] Once the connector is registered, connect from inside your client: ### Connect in Claude 1. Select the **+** icon → **Manage connectors**. [block:image] { "images": [ { "image": [ "https://files.readme.io/59adf717affa6820d19f2c41d13ae8dcd83afdb11aa4b274d7047f0c5ab75718-Screenshot_2026-05-27_at_10.10.36.png", "Claude chat input with the plus menu open and the Manage connectors option visible.", "Open Manage connectors from the + menu in Claude." ], "align": "center", "border": true } ] } [/block] 2. Select the Conveyor connector and click **Connect**. Since it's a custom connector, it appears under whatever name your admin gave it when registering it. [block:image] { "images": [ { "image": [ "https://files.readme.io/43a9526814d828c1b61672e1c5c8cab9f77514d8a1c0a94836e7727da78e05db-Screenshot_2026-05-27_at_10.10.59.png", "Claude connectors list showing the Conveyor connector with a Connect button.", "Select Connect next to the Conveyor connector in Claude." ], "align": "center", "border": true } ] } [/block] ### Connect in ChatGPT Business 1. Search for Conveyor in the app list. [block:image] { "images": [ { "image": [ "https://files.readme.io/1c5b2e5e7c2e808a1f6fa36b9bf0587408a2f580405c4cb447a1b31d0807a209-Screenshot_2026-05-27_at_10.20.40.png", "ChatGPT Business app directory with Conveyor shown in the search results.", "Search for Conveyor in the ChatGPT Business app list." ], "align": "center", "border": true } ] } [/block] 2. Select **Connect**. [block:image] { "images": [ { "image": [ "https://files.readme.io/a0df88f0f4652664280738dc2559758813064fe7f0b9cc910bf9a4f47c76db2a-Screenshot_2026-05-27_at_10.21.16.png", "Conveyor app detail view in ChatGPT Business with the Connect button visible.", "Select Connect to authorize the Conveyor app in ChatGPT Business." ], "align": "center", "border": true } ] } [/block] *** ## Option 2 — API Token (Bearer-Capable Clients) Any MCP-compatible client can connect by pointing to the server URL and including your API token as a Bearer token in the `Authorization` header: | Setting | Value | | -------------- | ------------------------------ | | **Server URL** | `https://mcp.conveyor.com/mcp` | | **Auth type** | Bearer token | | **Token** | Your Conveyor API token | Refer to your client's documentation for where to configure remote MCP servers. For example, in the OpenAI Playground: [block:image] { "images": [ { "image": [ "https://files.readme.io/fe93d71b6ef16fac482fe6aa34ae2a0333f391b6f46a49be0cf72bd0644d727e-Screenshot_2026-03-23_at_16.19.07.png", "OpenAI Playground MCP server configuration with the Conveyor server URL and Bearer token authentication fields filled in.", "Adding the Conveyor AI Connector to the OpenAI Playground using API token authentication." ], "align": "center", "border": true } ] } [/block] *** ## Option 3 — JSON-Configured Clients (Cursor, Claude Code, etc.) Add the following configuration to the client's JSON settings: ```json { "mcpServers": { "conveyor": { "url": "https://mcp.conveyor.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_TOKEN" } } } } ``` For Claude Code, you may also run the following command to add Conveyor to your MCP server list: ``` claude mcp add --transport http Conveyor https://mcp.conveyor.com/mcp --header "Authorization: Bearer YOUR_API_TOKEN" ``` *** ## Common Questions **Q: Do I need engineering help to set this up?** A: No. For OAuth-capable clients, add the server URL as a custom connector and the client handles the rest. For token-based clients, you paste a URL and a token — no custom integration, no API scripting. **Q: Which option should I pick if my client supports both?** A: OAuth. It's tied to your Conveyor user and inherits your per-organization permissions — see [Authentication](ai-connector#authentication) for the full comparison. **Q: My client connected, but the assistant isn't using Conveyor. What now?** A: Ask it explicitly — e.g. *"Using the Conveyor connector, show me questionnaires due this week."* Assistants with many connectors sometimes need a nudge toward the right tool. *** ## What's Next? * [Using the AI Connector](using-the-ai-connector) — example workflows to try with your newly connected client. * [Generating an API Token](https://docs.conveyor.com/reference/api-token) — create and scope a token for Bearer-based clients. *** **Need help?** Visit the [Integration Issues guide](integration-issues) or contact .