https://api.xplenty.com/api/mcp
This is the global URL. With OAuth you choose the account when you sign in; with a Personal Access Token, the account the token was created in is used. To connect several accounts at the same time, add one server per account with the per-account URL https://api.xplenty.com/YOUR_ACCOUNT_ID/api/mcp instead. See Connect a client.
Claude.ai web (OAuth custom connector)
Claude.ai supports custom connectors natively over OAuth, so there is no token to paste and no bridge to install.1
Open connector settings
In Claude.ai, go to Settings → Connectors and click Add custom connector.
2
Enter the endpoint
Enter a recognizable name (e.g. “Integrate.io”) and the endpoint URL above.
3
Authorize with OAuth
Authorize with OAuth. Sign in to Integrate.io if you aren’t already, then click Authorize. Claude stores the credentials and refreshes them automatically.
Claude.ai connects from Anthropic’s cloud rather than from your device, so the endpoint must be reachable over the public internet (the production URL is). See the reachability note in Authentication.
Claude Desktop (OAuth custom connector, recommended)
Recent Claude Desktop versions support the same OAuth custom connectors as Claude.ai web. Add the endpoint as a custom connector under Settings → Connectors, authorize with OAuth, and you are done, no token to manage.Claude Desktop (one-click extension)
If you’d rather use a Personal Access Token than OAuth, the quickest token-based option is the Integrate.io extension (.mcpb). The extension prompts you only for a Personal Access Token at install time, so you never touch claude_desktop_config.json by hand. The token decides which account the extension connects to: it connects to the account you created the token in.
Requires Claude Desktop 0.10 or later on macOS or Windows.
- In the Integrate.io dashboard, go to Settings → Developer Settings → Connected Applications.
- In the Quick install for Claude Desktop card, click Download Claude Desktop extension. The browser downloads
integrate-io-mcp.mcpb. - Open Claude Desktop and go to Settings → Extensions. Drag the downloaded
.mcpbfile onto that page. Claude Desktop opens the extension install dialog. - When prompted for a Personal Access Token, paste a PAT created in the account you want to connect (see Authentication). If you haven’t minted one yet, click + Create new connection on the Connected Applications page first.
- Click Install, then restart Claude Desktop (fully quit and reopen).
integrateio with the full tool list. See Verify below.
On a staging Integrate.io account the same card serves
integrate-io-mcp.staging.mcpb and displays a Staging build badge. The staging extension only talks to api-staging.xplenty.com, so it won’t work with a production PAT. Both extensions can be installed side by side. Claude Desktop treats them as separate integrations (integrate-io-mcp and integrate-io-mcp-staging).Updating or removing the extension
- Update: download the latest
.mcpbfrom the Connected Applications page and drag it onto Settings → Extensions again. The version field in the bundle increments on each release, so Claude Desktop treats it as an update rather than a duplicate. If the extension stops working after an update, open Settings → Extensions → Integrate.io in Claude Desktop and re-enter your token. To switch the extension to another account, enter a Personal Access Token created in that account. - Updating from version 0.1.x: earlier versions also asked for an account subdomain. Version 0.2.0 and later ask only for the token. A token created before connections were tied to one account doesn’t work with 0.2.0. If tool calls return
403with “This connection is not bound to an account”, create a new token in Connected Applications and enter it. - Remove: go to Settings → Extensions in Claude Desktop, find Integrate.io in the list, and click the remove/uninstall control. Optionally revoke the underlying Personal Access Token from Connected Applications in the Integrate.io dashboard.
Claude Desktop (token bridge, fallback)
If you can’t use the custom connector or the extension (an older Claude Desktop, corporate policy, or you’d rather hand-edit the config), connect over a token using themcp-remote bridge. Claude Desktop speaks MCP over stdio only, so the bridge turns the remote HTTP endpoint into a local stdio server.
Edit your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
mcpServers:
YOUR_ACCESS_TOKEN with a Personal Access Token (see Authentication), then restart Claude Desktop (Cmd+Q on macOS, fully quit and reopen; reloading the window isn’t enough).
Verify
In Claude Desktop, type/mcp in the chat input. You should see integrateio listed with its tools available. Try: “List the workspaces in my Integrate.io account.” Trouble connecting? See Troubleshooting.