Claude and ChatGPT
Chat apps have no shell, so they use your server’s remote MCP endpoint
(/mcp) instead of the CLI. Two things to add, each once:
- The connector: your server’s
/mcpURL. You sign in with OAuth, and the app gets the MCP tools with the scopes you tick. - The skill:
therunbook-skill.zipfrom the latest release. It teaches the model the agent loop, when to ask a person, and how to write runbooks.
What works well from a chat: asking what a run is waiting on, finding past runs and memory, drafting and validating a runbook, and working an agent step with you watching. Long unattended work belongs in an agent with a shell or a launcher.
Claude
Section titled “Claude”Works in Claude on the web, Claude Desktop and the mobile apps (one setup, on your account). Custom connectors and skills are available on Claude’s paid plans; on Team and Enterprise an owner may need to allow them first.
-
Add the connector. In Claude, open Settings → Connectors, choose Add custom connector, name it
The Runbookand enterhttps://runbooks.example.com/mcp. Choose Connect: your server’s sign-in page opens. Sign in, tick the scopes Claude may use (runbooks:publishstays off unless you tick it) and approve. -
Upload the skill. Download
therunbook-skill.zip, then in Settings → Capabilities → Skills choose Upload skill and pick the zip. On Team and Enterprise plans an owner can upload it once in the organization settings, so everyone gets it. -
Try it in a new chat with the connector turned on:
What is run exe_01JD2X6PZ5R8E2W4Y6A0C3D5F7 waiting on?
Claude’s help center covers skills and custom connectors in detail.
ChatGPT
Section titled “ChatGPT”ChatGPT connects to MCP servers in developer mode, and reads skills in the same folder format as Claude. Which plans have each feature, and whether a workspace admin has to turn it on first, changes often: check OpenAI’s developer mode article and skills guide.
-
Turn on developer mode in ChatGPT’s settings (under the apps or connectors section’s advanced settings). On Business, Enterprise and Edu workspaces an admin enables it for the workspace.
-
Create the connector with the URL
https://runbooks.example.com/mcpand OAuth authentication. ChatGPT registers itself with your server; sign in and tick the scopes it may use. -
Upload the skill where your plan offers skills, using
therunbook-skill.zip. Without skills on your plan, the connector still works: the tools describe themselves, and the prompt library has prompts to paste. -
Try it in a chat with the connector selected.
ChatGPT’s deep research and company knowledge use the connector’s read-only
search and fetch tools to find and read your runbooks, runs and memory.
What the connector can and can’t do
Section titled “What the connector can and can’t do”The connector is an OAuth grant: the server records it as an agent you sponsor, with only the scopes you ticked. It can claim and report agent steps, search runs and memory, and draft and validate runbooks. It can never decide a human approval, even though you signed it in.
See and disconnect connected apps with runbook apps list and
runbook apps revoke <client>, or remove the connector in the app.