Chapter V · Section 1

Connect Grimoire to your AI

Bring the AI assistant you already use. Sign in once, pick a campaign, and ask about your world in plain English.

Grimoire is an MCP server. Any AI app that supports remote MCP servers with sign-in can connect to it: you paste one URL, sign in with your Grimoire account, and pick the campaign it may use. No installs, no config files, no API keys to copy.

Which AI apps work

These are the apps we have connected to Grimoire ourselves.

App	Plan needed	Reads	Edits
Claude (web, desktop, mobile)	Free and up	Yes	Yes
Claude Code	Paid Claude plan or API account	Yes	Yes
ChatGPT (web)	Plus or Pro, Developer Mode	Yes	May be limited
Cursor	Cursor plan with MCP	Yes	Yes

Plans checked September 2026. AI companies change these often; check your app's help center if something looks different.

Set up your app

Claude

On claude.ai, open Customize (on some accounts, Settings), then Connectors.
Click Add custom connector and paste the server URL:

https://api.ttrpg.bot/mcp

If Claude asks how to set up sign-in, choose Register automatically. Click Add, then Connect. A Grimoire sign-in page opens.
Sign in with the account you use for Grimoire, pick a campaign, and click Approve & connect.
Ask something like "What NPCs are in my campaign?"

Claude Desktop uses the same Connectors flow. Connectors you add on the web or desktop also work in the Claude mobile apps.

ChatGPT

On chatgpt.com (web only), open Settings, then Apps.
Under Advanced settings, turn on Developer mode. This needs a Plus or Pro plan.
Back in Apps, click Create, name it Grimoire, and paste:

https://api.ttrpg.bot/mcp

Choose OAuth sign-in, sign in to Grimoire, pick a campaign, and click Approve & connect.
In a new chat, enable the Grimoire app from the tools menu.

On Plus and Pro, OpenAI may limit custom connectors to reading. If ChatGPT can look things up but will not create or edit, that is a ChatGPT plan limit, not a Grimoire setting.

Claude Code

In a terminal, run:

claude mcp add --transport http grimoire https://api.ttrpg.bot/mcp

Start Claude Code and type /mcp, choose grimoire, and sign in.
Pick a campaign and click Approve & connect.

Cursor

Open Cursor Settings, then MCP, and add a new MCP server.
Use the URL https://api.ttrpg.bot/mcp (in mcp.json: { "mcpServers": { "grimoire": { "url": "https://api.ttrpg.bot/mcp" } } }).
Cursor opens a Grimoire sign-in page. Sign in, pick a campaign, and click Approve & connect.

Other apps

Look for custom connector, remote MCP server, or add MCP server in your app's settings.
Choose the option that signs in with OAuth (sometimes called "automatic" or "register automatically"). Apps that only accept an API key or token cannot connect.
Paste https://api.ttrpg.bot/mcp, sign in to Grimoire, pick a campaign, and approve.

ChatGPT status

These apps document the kind of sign-in Grimoire uses. We have not tested them ourselves yet, so treat them as "should work".

App	Plan needed	Reads	Edits
Mammouth Not yet tested by us	Mammouth subscription (one plan covers GPT, Claude, Gemini, Mistral and more)	Should	Should
TypingMind Not yet tested by us	Multi-model app, bring your own model API keys	Should	Should
LM Studio Not yet tested by us	Local and desktop app	Should	Should
Jan Not yet tested by us	Local and desktop app	Should	Should
Cherry Studio Not yet tested by us	Local and desktop app	Should	Should
GitHub Copilot in VS Code Not yet tested by us	Copilot Free and up	Should	Should
Zed Not yet tested by us	Editor	Should	Should
Cline Not yet tested by us	Editor agent	Should	Should
Goose Not yet tested by us	Agent	Should	Should
n8n Not yet tested by us	Automation	Should	Should

Multi-model apps, local and desktop apps, editors and agents, and automation tools, listed from each app's own documentation. Check the app's plans before you rely on it.

Next steps

MCP Reference: player access, switching campaigns, revoking access, every tool, and troubleshooting.
AI Context: decide what your assistant knows by default.