Server address
Conductor’s MCP server is athttps://mcp.conductor.is/, and an AI tool connects to it by signing in to Conductor or with a Conductor key. For read-only access, use https://mcp.conductor.is/read-only instead.
If you’re building your own agent on Conductor’s MCP, or you’re an AI agent learning how it works, the MCP tools reference lists every tool and how each call behaves.
Setup
Most AI tools connect by signing in to Conductor in your browser, so there’s no key to copy. Your AI tool can run anywhere, but QuickBooks Desktop and the Web Connector must be running on the computer you connected to Conductor.- Claude
- ChatGPT
- Claude Code
- Codex CLI
- Cursor
- VS Code
- Copilot Studio
- Other clients
These steps work for claude.ai, Claude Desktop, and Cowork.
- In Claude, open Customize > Connectors, click Add, then click Add custom connector.
-
Name it
Conductor, paste the URL below, and click Continue. - Leave Sign in now and Use Claude’s published identity selected, click Add, then click Connect.
- Sign in to Conductor, pick your project, and click Allow. This adds an “MCP (Claude)” key to your Conductor project’s API Keys page. If you ever need to revoke access, delete that key.
- In a Claude chat, turn on Conductor under + > Connectors. Claude reads without asking and asks before each tool that changes QuickBooks; choose Always allow to stop asking for that tool (in Cowork, Allow for all tasks).
conductor entry in its local config from the conductor-node-mcp package, remove it; the connector replaces it. To connect Claude Desktop’s local config with a key instead, on Windows or macOS, follow the Other clients steps.Read-only mode
Read-only mode lets the AI tool read your QuickBooks data and blocks creates, updates, and deletes before they reach QuickBooks. Use it for a trial, an accountant, or co-workers who should only read. The URL or header below limits the connection, not the Conductor key.- Claude
- ChatGPT
- Claude Code
- Codex CLI
- Cursor
- VS Code
- Copilot Studio
- Other clients
Follow the Claude steps in Setup, but name the connector The read-only connector’s key is named “MCP (Claude, read-only connection)” on your Conductor project’s API Keys page.
Conductor read-only and paste the URL below. The Claude Free plan allows only one custom connector, so remove the full-access connector first if you added it.Verify it works
Ask the agent: “Show the 5 most recent invoices using my most recently successful QuickBooks Desktop connection.” If it returns real data, you are set up. A “connected” indicator proves only that the sign-in or key worked; QuickBooks Desktop is reached only when a tool runs. If your project has several company files, the AI tool usually asks which one you mean, or you can name the file in your question.Timeouts and QuickBooks Desktop
Your AI tool reaches QuickBooks Desktop through the Web Connector on the computer that holds the company file, so QuickBooks Desktop and the Web Connector must be running there.- QuickBooks Desktop answers one request at a time for each company file. Calls to the same file wait their turn, so asking for several things at once doesn’t make them faster.
- The first request after a pause can take 3 to 10 seconds, and up to 90 seconds when the Web Connector must open the company file.
- When QuickBooks doesn’t answer in time (90 seconds, or 50 seconds through the
conductor-node-mcppackage except in Claude Code), the call fails withQBD_REQUEST_TIMEOUT. A change that timed out may still have been saved, so ask the AI tool to check before repeating it. - Codex waits up to 300 seconds for a tool by default (its docs page still says 60). If you use
execute, or your Codex stops a call at 60 seconds, addtool_timeout_sec = 300under[mcp_servers.conductor]in~/.codex/config.toml.
Troubleshooting
Claude shows Conductor as connected, but every request fails
Claude shows Conductor as connected, but every request fails
This usually means the Conductor key behind the connector was deleted, and Claude doesn’t ask you to sign in again on its own. In Claude, open Customize > Connectors, disconnect Conductor, and click Connect on it again. Then sign in to Conductor, pick your project, and click Allow. If the error mentions QuickBooks Desktop or the Web Connector, signing in again won’t help; see “Requests to QuickBooks fail” below.
Couldn't reach the MCP server
Couldn't reach the MCP server
This means the URL you entered isn’t one of Conductor’s:
https://mcp.conductor.is/ or https://mcp.conductor.is/read-only. Remove the connector in Claude or the plugin in ChatGPT, then add it again with the URL from the steps above.Copilot Studio says the MCP server rejected the request
Copilot Studio says the MCP server rejected the request
This means the server URL is wrong: use
https://mcp.conductor.is/mcp, or https://mcp.conductor.is/read-only for read-only access. If the message says “(HTTP 401)” instead, the connection’s key value isn’t Bearer sk_conductor_...: the word Bearer, one space, and your secret key, with no quotes and no Authorization: in front. Remove the tool, add it again with the Copilot Studio steps in Setup, and create a new connection.Claude asks before every change
Claude asks before every change
Claude asks before each tool that changes QuickBooks, such as
create_invoice, until you choose Always allow for that tool; tools that only read don’t ask. On a Claude Team or Enterprise plan, members can’t choose Always allow for a tool an Owner set to Needs approval under Tool permissions. If Claude Desktop also has a conductor entry from the local conductor-node-mcp package, open Settings > Developer > Edit Config, remove that entry, then fully quit and reopen Claude Desktop.An error names the company file
An error names the company file
MULTIPLE_COMPANY_FILES means your project has several connected company files and the AI tool didn’t say which; it usually lists them and asks you, or you can name the file in your question. COMPANY_FILE_NOT_FOUND means the AI tool named a company file that isn’t in the project your key belongs to; ask it to list your company files and use one of those. NO_COMPANY_FILE means no company file in the project has answered a request yet: finish connecting one in the Conductor Dashboard, then make sure QuickBooks Desktop and the Web Connector are running.A result says truncated
A result says truncated
This means the answer was too long for one result, so records were dropped from the end. Ask for fewer records, a shorter date range, or narrower filters; for a report, shorten the period or filter it. When you need all of it, such as for a total, ask the AI tool to read every page or the whole report in one call with
execute.A change fails on a read-only connection
A change fails on a read-only connection
READ_ONLY_CONNECTION means the connection uses the read-only URL or header, which blocks changes. To make changes, add a second connection to https://mcp.conductor.is/ with the Setup steps, or remove the read-only header.RATE_LIMITED: too many calls at once
RATE_LIMITED: too many calls at once
This means the AI tool started more calls at once than one Conductor key can run. QuickBooks Desktop answers one request at a time for each company file anyway, so more parallel calls would only wait. Wait a few seconds and try again, or ask the AI tool to make fewer calls at once. Co-workers who share one key share this limit; signing in gives each person their own key.
Calls time out
Calls time out
QBD_REQUEST_TIMEOUT means QuickBooks Desktop didn’t answer in time, often because it was opening the company file or busy with another request. Ask again; a change that timed out may already be saved, so ask the AI tool to check before repeating it.EXECUTE_TIMEOUT means execute code didn’t finish within about 5 minutes (50 seconds through the conductor-node-mcp package except in Claude Code): the job may be too big for one call, or QuickBooks Desktop may have been slow to answer a request. First ask the AI tool to check what the code saved, since a change it sent can be saved even after the error. Then ask it to run the code again if the code makes only a few requests, or to split the job across shorter calls if it works through many records.Codex waits up to 300 seconds for a tool by default (its docs page still says 60). If you use execute, or your Codex stops a call at 60 seconds, add tool_timeout_sec = 300 under [mcp_servers.conductor] in ~/.codex/config.toml (see the Codex CLI setup steps).API key missing or invalid (if you pasted a key)
API key missing or invalid (if you pasted a key)
This means your AI tool isn’t sending a valid Conductor key. Create a new key on your project’s API Keys page in the Conductor Dashboard (for other clients, the MCP tab’s Create key and fill in config fills it into the config for you). Paste the new key or config into your AI tool, then restart it. If the local
conductor-node-mcp package fails to start, install Node.js (LTS), then fully quit and reopen your tool.Grok can't connect
Grok can't connect
Grok’s connectors on grok.com can’t connect to Conductor. Grok Bot in Cursor’s cloud agents works with a key from the Other clients setup above.
Requests to QuickBooks fail
Requests to QuickBooks fail
This usually means QuickBooks Desktop or the Web Connector isn’t running on the computer you connected to Conductor. Make sure both are running there. Connecting an AI tool doesn’t need any Web Connector changes.
Can my co-workers use the same key on other computers?
Can my co-workers use the same key on other computers?
Yes. A key works on any number of computers and AI tools, so co-workers can paste the same key. In any tool that signs in, each co-worker can instead sign in to Conductor with their own account, which creates a separate key for them; they must be members of your Conductor organization. Pricing is per QuickBooks company file, so you aren’t charged extra for more co-workers, keys, or AI tools connecting to the same company file.When someone leaves, remove them on the Members page in the Conductor Dashboard, then delete their keys named “MCP (…)” on the project’s API Keys page; the “Created by” column shows whose each key is. Removing a member doesn’t delete their keys.
I see SEO tools, not QuickBooks (wrong Conductor)
I see SEO tools, not QuickBooks (wrong Conductor)
This means you’re connected to the MCP server of an unrelated SEO company at
conductor.com. Its tools include ai_brand_insights and keyword_insights, and it returns “couldn’t identify the caller” errors. Remove it and add https://mcp.conductor.is/ instead. Ours is at conductor.is, and its tools include list_invoices and run_summary_report.
