Connect Claude or ChatGPT
Connect Claude or ChatGPT to instruction.md, and you can ask it to read, change and follow your instructions in a chat. This page shows you how to add the connection, choose what the app may do, and change your mind later.
What you get
Once connected, Claude or ChatGPT works in instruction.md as you. It can see the instructions you can see, and nothing more. Depending on what you allow, it can:
- read an instruction and follow it for the rest of the chat;
- show you a draft inside the chat, suggest changes and answer comments;
- publish a new version, after asking you;
- share or delete instructions, if you allow everything.
It never gets more than your own role allows. If you can only read an instruction, the app can only read it too.
Reading and live updates
An AI app gets your instructions in two ways.
- Reading. It asks for an instruction when it needs it, and gets the live version. Reading is never limited, on any plan.
- Live updates. instruction.md tells the app the moment a new version is published, so it doesn't have to ask.
Some plans give live updates to only a set number of agents and AI apps at a time. This is how many each plan allows:
Plans Community 1 · Pro unlimited · Team unlimited · Enterprise unlimited
When the places are taken, another app still works: it reads the live version whenever it checks, and gets live updates once a place is free. The editor itself never takes a place.
Before you start
- An instruction.md account. How signing in works.
- Claude (on claude.ai or the Claude desktop app) or ChatGPT.
- In ChatGPT, Developer mode. On ChatGPT Business or Enterprise, an admin must allow custom connectors first.
You can also find these steps in the editor. Open an instruction, choose Share ▸ Connect an agent…, and pick Claude or ChatGPT under Where does your agent run?
This is the address you paste in both apps:
https://instruction.md/mcp Connect Claude
Open the connectors
In claude.ai or the Claude desktop app, open Settings ▸ Connectors and choose Add custom connector.
Name it and paste the address
Name it
instruction.md, and paste the address above as the server's address. Leave Advanced settings empty: Claude sets itself up.Add it and sign in
Choose Add, then Connect. An instruction.md sign-in page opens. Sign in with your instruction.md account.
Choose what Claude may do
The page asks What may Claude do? Choose one of the four, and whether it may Follow changes live (see below). Choose Continue, then agree on the next page.
Try it
Start a chat and ask Claude to read one of your instructions.
Connect ChatGPT
Turn on Developer mode
In ChatGPT, open Settings ▸ Security and login and turn on Developer mode.
Create the connector
Open Settings ▸ Connectors and choose Create. Name it
instruction.md, paste the address above as the server's address, and choose OAuth for Authentication.Sign in
Choose Create. An instruction.md sign-in page opens. Sign in with your instruction.md account.
Choose what ChatGPT may do
The page asks What may ChatGPT do? Choose one of the four, and whether it may Follow changes live. Choose Continue, then agree on the next page.
Try it
In a new chat, turn the instruction.md connector on, then ask ChatGPT to read one of your instructions.
Claude and ChatGPT name their own menus, and they sometimes rename them. If a menu above isn't there, look for connectors in the app's settings.
Check it worked
In a new chat, ask the app which of your instructions it can see. It answers with their names. If it says it has no instruction.md connector or actions, see If it doesn't work.
Choose what the app may do
The first time an AI app connects, instruction.md asks What may it do? Each choice includes the one before it.
| Choice | What the app can do |
|---|---|
| Read only | Read your instructions and their versions. It changes nothing. |
| Read and write drafts | Also change drafts, suggest changes and comment. Nothing is published. |
| Read, write and publish | Also release new versions, after asking you. This one is chosen when the page opens. |
| Everything you can do | Also share, delete, and manage what you manage. |
A separate switch, Follow changes live, lets the app hear when an instruction it follows changes, without asking again. It is on when the page opens. For an app that should only read and follow, choose Read only and leave the switch on.
The app only sees the actions your choice allows. instruction.md refuses anything else it tries.
Ask it to follow an instruction
Type a request in the chat, with your instruction's name. For example:
Read acme/support-agent and follow it in this chat.
Show me the draft of acme/support-agent and suggest a clearer refund rule.
What changed between v3 and v4 of acme/support-agent? To follow an instruction, the app reads the version that is live now and treats it as its instructions for the rest of the chat. Where the app lists the connector's prompts, you can also pick Follow an instruction and give it the instruction's name.
When the app opens an instruction, it can show the draft right in the chat. There you can:
- see the draft as the site shows it, or choose Show Markdown;
- Accept or Reject each suggested change, or choose Accept all;
- read what the editor's check found, such as No problems found.;
- choose Edit, change the text, and Save it to the draft (or Send as suggestions, if you can only suggest);
- reply to comments, Resolve them, or add your own;
- choose Publish, or Open in the editor for everything else.
Why it asks you first
Some actions change what other people and agents get, or can't be undone. Before any of them, instruction.md stops and makes the app ask you. The app shows you what will happen. Only if you agree does it go ahead. It must never answer for you.
The app asks you before it:
- publishes a version that agents following the live version switch to;
- makes the live version an older one, or moves another name such as stable;
- makes an instruction public, or gives people more access;
- moves an instruction to another workspace;
- moves an instruction, a folder or a project to the trash, or deletes something for good;
- throws away the changes in a draft;
- merges changes someone offered into the instruction;
- withdraws a version, or schedules a publish for later;
- deletes your account, or changes your organization's people, sign-in or keys, if you let it manage them.
The answer is good for ten minutes, and for that one action only. If you say no, nothing changes.
When you publish from the draft in the chat, you are asked twice: first What changed, then what the server says will happen.
Change or disconnect it later
Open Connected apps
In the editor, open Your account ▸ Connected apps.
Change what they may do
Under AI apps acting as you, choose Change what they may do. A page lists each AI app you connected.
Choose, or disconnect
For each app, pick what it may do and whether it may Follow changes live. To remove one, tick Disconnect this app. Then choose Save.
A change takes effect within a few minutes. A disconnected app can't reach your instructions any more. To use it again, connect it again, and you are asked What may it do? again. More in Connected apps.
An app you connected before instruction.md asked What may it do? acts as you in full. It is asked the next time it signs in.
You can also remove the connector in Claude's or ChatGPT's own settings. That stops the app on its side.
If it doesn't work
| What you see | What to do |
|---|---|
| No sign-in page opens after Connect or Create | Check the address: it is https://instruction.md/mcp, exactly. In ChatGPT, check that Authentication is OAuth. On ChatGPT Business or Enterprise, ask your admin to allow custom connectors. |
| The app says it can't connect, or shows no actions | Update the app. instruction.md only accepts the newest way AI apps connect, and an older app version can't use it. |
| "Not found", or the app can't see an instruction | Check the instruction's name. The app sees only what you can see: if the instruction is private and not shared with you, the app can't read it either. Share an instruction. |
| The app can't manage your organization's people, workspaces or billing | The app gets these actions only if you chose Everything you can do and the app asked for them when it connected. If it didn't, manage your organization in the editor's Settings instead. |
| The app is told that live updates are taken, and to try again later | Your plan gives live updates to only so many agents and apps at a time, and another one has them now. Your app still works: it reads the live version whenever it checks. Plans and limits. |
| The app does less than you expected | Check what you allowed under Your account ▸ Connected apps. |
Still stuck? Ask us, or see Something isn't working.
Questions
How do I connect Claude or ChatGPT, and what can it do in my account?
Add a custom connector with the address https://instruction.md/mcp and sign in. You then choose what it may do: read only, write drafts, publish, or everything. It never does more than your own role allows. See Choose what the app may do.
Why does the AI app ask me before publishing?
Publishing changes what the agents that follow your instruction receive. instruction.md makes the app stop and show you what will happen, and goes ahead only if you agree. See Why it asks you first.
Can I connect more than one AI app?
Yes. Each app you connect asks what it may do, and you can change each one later. Some plans give live updates to only a few of them at a time; all of them can always read. See Reading and live updates.
Does disconnecting delete anything?
No. Your instructions stay as they are. The app only loses access, within a few minutes. See Change or disconnect it later.
For developers: Connect an MCP client has the technical details, including other apps and agents that run on their own.