---
title: "Connect Quest Portal to Claude and ChatGPT"
description: "Quest Portal has an MCP server, a secure link that lets an AI assistant such as Claude or ChatGPT work in your Quest Portal account."
canonical: "https://www.questportal.com/documentation/page-f29d5d823ab5891314a469e5/connect-quest-portal-to-claude-and-chatgpt"
section: "Documentation"
source: "Quest Portal documentation"
version: 237
---

# Connect Quest Portal to Claude and ChatGPT

> Ask Claude or ChatGPT to prep your campaign, and it makes the changes in Quest Portal for you.

Quest Portal has an MCP server, a secure link that lets an AI assistant such as Claude or ChatGPT work in your Quest Portal account. Once connected, you can ask in your own words ("Create an NPC for the tavern keeper", "Move Thursday's session to 7:30") and the assistant reads and updates your campaigns, characters, notes, scenes, schedules and dice skins.

Available with Core and Pro, including the free trials, on any plan of Claude or ChatGPT that supports custom connectors. With Core, your assistant can read your campaigns. With Pro, it can also make changes.

## Who can use it

- **Pro members:** your assistant can read and change everything in all your campaigns. The 30-day Pro trial counts.
- **Core members:** your assistant can read your campaigns, characters and sheets, notes, scenes, schedules, past sessions and invite links, and search this documentation. Making changes, searching your notes, library or music, and the dice skin tools need Pro. The Core trial counts.
- **Members of a Pro campaign:** if you don't have Pro yourself, but another member of a campaign you're in has Pro, your assistant can work in that campaign and nowhere else. Creating new campaigns and the dice skin tools still need your own Pro; Pro shared in a campaign doesn't cover them.
- **Everyone else:** you can add the connector and sign in, but the assistant can't read or change your data until you have Core or Pro. Start a trial or choose a plan first.

Your access is shown at the top of https://app.questportal.com/settings/mcp.

![](https://cdn.questportal.com/-/L3B1YmxpYy93ZWIvbGlicmFyeS9yRkxjdDJZcTBUc3ovNjhmNmZlM2IzMjQ1OWM2M2VjOTE0MzU5Y2VlNGJhOTFiMTI4Y2QxYjBhNTQ2NzQzNTc3OGE3NGM2N2ZhZmVjMy5qcGc)

## What you can ask it to do

The assistant acts as you, so it can only open campaigns, characters and notes you can already open, and only the campaign owner can change campaign-wide things like the schedule.

With Core, your assistant can look things up but not change them. Everything below that creates, changes, searches or deletes needs Pro.

**Campaigns**

- Create a campaign, rename it, or rewrite its description. Creating a new campaign needs your own Pro.
- Change the campaign's profile picture, cover image and cover position.
- See your campaign's active invite links.
- Search the books in your campaign library and quote the exact page.

**Characters**

- Create player characters, hidden NPCs or claimable characters, from a blank sheet or a character sheet template (including Call of Cthulhu 7e).
- Change a character's name, tagline, portrait or visibility to players.
- Read and fill in character sheet tabs, and update Call of Cthulhu 7e characteristics, skills and weapons.

**Notes**

- Write new notes (private or shared with the campaign) and rewrite existing ones.
- Create note folders and move notes between them.
- Add images to a note.
- Search across your campaign notes.

**Scenes and music**

- Create scenes from an image, rename them and change their description or background.
- Organize the scene bar into folders, and add scenes from your gallery.
- Find tracks in the Quest Portal music library, add your own MP3s, and reorder or remove a scene's soundtrack.

**Sessions and scheduling**

- Set up or change the campaign's recurring session schedule.
- List upcoming sessions, see who is going, and answer Going / Not going for yourself.
- Get a calendar file (.ics) for a session.
- Read past sessions: attendance, recaps and a timeline of scenes and dice rolls.

**Dice skins**

- Design a new dice skin, import one, equip it or delete it. These tools need your own Pro; Pro shared in a campaign doesn't cover them. See [Dice](https://www.questportal.com/documentation/uW87zSfxNi/dice) to learn how dice skins appear when you roll.

**Help**

- Search this documentation to answer "how do I…" questions.

> **Note:** The assistant can't roll dice for you, run the initiative tracker or encounters, change maps, tokens or fog of war, or buy anything. Those stay in Quest Portal.

## Connect Claude (web and desktop)

You need to do this once, on a computer. After that, Quest Portal also works in the Claude mobile apps.

1. In Quest Portal, open https://app.questportal.com/settings/mcp, choose **Claude**, and click **Copy** next to mcp.questportal.com/mcp.
2. In Claude on the web or in the desktop app, open **Customize**, then **Connectors**.
3. Click to add a **custom connector**, name it "Quest Portal", paste the link https://mcp.questportal.com/mcp, and click **Add**. Leave the advanced OAuth settings empty.
4. Click **Connect**. A Quest Portal page opens.
5. Sign in to Quest Portal if asked. The page reads "Allow Claude to access Quest Portal?" and lists what Claude will be able to use: Characters, Campaigns, Dice, Notes and Scenes.
6. Click **Allow access**. You're returned to Claude, and the connector shows as connected.
7. In a new chat, make sure Quest Portal is turned on in the chat's tools menu, then ask away. Claude asks for your approval before it changes anything, unless you tell it to always allow a tool.

![](https://cdn.questportal.com/-/L3B1YmxpYy93ZWIvbGlicmFyeS9yRkxjdDJZcTBUc3ovOTFiOTgzYjMzYjNkNGE4YjI4NWM4MmNhOTBjYmMwNzNiMzk4MDE1Nzg4YzEyOTVlODdjNzQ4ODRhMTkzNTA1NS5qcGc)

> **Note 1:** On a Claude Team or Enterprise plan, an owner of your Claude organization may need to add the connector first. You then connect it with your own Quest Portal account.
>
> **Note 2:** "Client metadata loaded securely from claude.ai" on the approval page means the request really comes from Claude. Only approve requests you started yourself.

## Connect Claude Code

In a terminal, run this command:

> claude mcp add --transport http questportal https://mcp.questportal.com/mcp

Then start Claude Code, type /mcp, choose **questportal** and sign in. Your browser opens the same Quest Portal approval page; click **Allow access**.

## Connect ChatGPT

You need to do this once, in ChatGPT on the web. Adding your own app requires ChatGPT's developer mode, which depends on your ChatGPT plan and, on work plans, on your workspace admin.

1. In Quest Portal, open https://app.questportal.com/settings/mcp, choose **ChatGPT**, and click **Copy** next to mcp.questportal.com/mcp.
2. In ChatGPT on the web, open **Settings**, then **Apps** (called Apps & Connectors on some plans).
3. Under **Advanced settings**, turn on **Developer mode**.
4. Click **Create** (or **Add custom MCP server**), name it "Quest Portal", paste https://mcp.questportal.com/mcp, and choose **OAuth** for authentication. Keep the default client settings.
5. Click **Create**. A Quest Portal page opens.
6. Sign in to Quest Portal if asked. The page reads "Allow ChatGPT to access Quest Portal?". Click **Allow access**.
7. In a new chat, pick Quest Portal from the chat's **+** menu and ask away. Depending on your ChatGPT settings, it may ask you to confirm before it writes.

## Other assistants

Any assistant that supports remote MCP servers with OAuth can connect. Add https://mcp.questportal.com/mcp as a custom connector or MCP server, then approve access on the Quest Portal page. For better results, give your assistant the Quest Portal agent skill, linked from https://app.questportal.com/settings/mcp.

## Credits

Using Quest Portal through Claude or ChatGPT does not spend your Quest Portal credits. The AI runs on Claude's or ChatGPT's side and counts toward your plan there. Quest Portal credits are only used by AI features inside Quest Portal, such as the [Game Master Assistant](https://www.questportal.com/documentation/Yb0-dxbYaV/game-master-assistant) and image generation. See [What are Credits?](https://www.questportal.com/documentation/n0ew5C2od2/what-are-credits)

## What it can access

- **It acts as you.** The assistant has the same access you have: campaigns you're in, characters you own or can edit, and notes you can open. It can't see other people's private notes or other players' accounts.
- **You approve it.** Nothing is shared until you click **Allow access**. The approval page lists what the assistant asks to use (Characters, Campaigns, Dice, Notes, Scenes).
- **It doesn't last forever.** Approval gives renewable access for up to 30 days. If you stop using it, connect again.
- **It can't buy anything or change your account.** It can't make purchases, change your plan, or see your payment details.
- **It edits, so check its work.** The only thing it deletes outright is a dice skin you created, but it can rewrite notes and character sheet tabs. Review what it changed, especially in shared campaign notes.
- **What leaves Quest Portal:** whatever the assistant reads (for example a note it searched) is sent to Claude or ChatGPT to answer you, and is handled under their terms and privacy settings.

## See and disconnect connected assistants

Open https://app.questportal.com/settings/mcp. Under **Connected assistants** you see each assistant you approved, what it can use, when you approved it and when it was last active.

1. Click **Disconnect** next to the assistant.
2. Confirm in the "Disconnect assistant?" dialog.

The assistant loses access within 15 minutes. You can also remove the connector in Claude or ChatGPT, but disconnecting in Quest Portal is what cuts off its access. To use it again, connect it again from Claude or ChatGPT.

## Where it appears

- **Web:** your profile menu > Account settings > **Connect to MCP**, or https://app.questportal.com/settings/mcp.
- **Mobile app:** Settings > **AI assistants** > **Connect to MCP** shows your access, the setup steps (with **Email me these steps**, so you can finish on a computer) and your connected assistants.

## Troubleshooting

**The assistant says a tool needs Quest Portal Pro.** With Core, your assistant can read your campaigns but can't make changes or run searches. Upgrade to Pro, or use a campaign where another member has Pro. Without a plan or trial, start one at https://app.questportal.com/settings/mcp, then try again.

**"Authorization could not be completed."** Go back to Claude or ChatGPT and connect again. Make sure you're signing in to the Quest Portal account you want the assistant to use.

**The assistant doesn't use Quest Portal.** Turn Quest Portal on in that chat's tools menu (Claude) or pick it from the + menu (ChatGPT), and mention Quest Portal in your request.

**It worked before and now it doesn't.** You may have disconnected it, or it hasn't been used for 30 days. Connect it again.

**It says it can't change something.** Some changes are only for the campaign owner (for example the schedule, the campaign name and photos, invite links), and characters must be ones you can edit.

**A change doesn't show up.** Refresh the page in Quest Portal. If the assistant says another edit happened at the same time, ask it to read the note or sheet again and retry.

## Notes

> **Note 1:** The assistant works on your Quest Portal data, not on live play. Use it to prepare between sessions; it doesn't join voice chat or move tokens.
>
> **Note 2:** Claude and ChatGPT are third-party apps. Quest Portal provides the connection; how they use what they read is set by their own terms and your settings there.

---

Part of the [Quest Portal documentation](https://www.questportal.com/documentation.md) (Documentation). HTML version: <https://www.questportal.com/documentation/page-f29d5d823ab5891314a469e5/connect-quest-portal-to-claude-and-chatgpt>.
