Where every setting is
Every settings page of the editor: where it is in the side bar, its address, what it holds, the MCP tools behind it, the plans it needs and who can use it. Use it to find the tool or command behind a setting you see in the editor, or the setting behind a tool.
How to read the map
The settings are in four places in the editor:
- Your account: the menu under your name, at the foot of the side bar.
- Settings: a group of the side bar, there when the server offers any of People, Security or Billing.
- Integrations: a group of the side bar; pressing its name opens the overview.
- Developer: a group of the side bar, only while Developer mode is on; pressing its name opens Apps.
Each page below is written as the docs and Learn write it: the group, then the page, in bold with ▸, such as Settings ▸ People. Under each page:
| Field | What it says |
|---|---|
| Address | The page's address on https://instruction.md. <owner> is the organization's URL name. Opening the address opens the page directly, and can be bookmarked or linked |
| Sections | The page's headed sections, in the order the page draws them. A page may leave out a section you have no role for |
| Appears when | The tool whose presence in the server's tools/list makes the page appear, or the condition for a page no tool gates. A server without that tool, such as a self-hosted one without billing, has no such page: the side bar draws no row, and the address shows the not-found view |
| Tools | The MCP tools the page calls to read and change what it shows. Anything you do on the page, an MCP client can do with these tools and a token that may call them |
| Plan | The plan keys that gate the page, or part of it, from billing/plans.json |
| Who | Who can open the page, and who can change what is on it |
| CLI | The instruction commands that read or change the same things, where there are any |
Three addresses behave differently:
/settingsopens Profile, or Appearance when you aren't signed in.- An organization's page without its owner, such as
/settings/billing, opens that page of the organization you have open. A?org=with the organization's id opens that organization's instead. /<owner>/-/settings/integrations/registriesopens the MCP page, which lists registries and servers together.
The Developer group appears only while Developer mode is on. Turn it on in Settings ▸ General ▸ For developers ▸ Developer mode. Signed in, the choice follows you to your other devices. An organization's owners and admins can set what new members start with on the same page; each person's own choice wins. While Developer mode is off, Settings ▸ Security shows "Single sign-on, domains, agent credentials and signing are in Developer" with Open Developer.
Your account
Your account ▸ Profile
How you appear to the people you work with, and in what agents report.
| Address | /settings/profile |
|---|---|
| Sections | About you · Where you are |
| Appears when | Always |
| Tools | me_profile_update, me_preferences_set |
| Plan | Every plan |
| Who | Anyone signed in. A guest is asked to sign in. |
| CLI | instruction whoami |
| More | Profile, notifications and appearance |
Your account ▸ Security
How you sign in, and where you're signed in.
| Address | /settings/sign-in |
|---|---|
| Sections | Passkeys · Recovery codes · Signed in with · Where you're signed in · Your profile |
| Appears when | When the editor's access token is for the sign-in service's account API (its audience includes account). The account menu has no Security row, and the address shows the not-found view, until then |
| Tools | None. It reads and changes your account in the sign-in service directly |
| Plan | Every plan |
| Who | Anyone signed in, with the editor's own sign-in; the menu shows it only then. It reads and changes the sign-in service's account (no MCP tool), so an AI app's or the CLI's token can't open it. |
| More | Passkeys · Recovery codes · Your devices and linked sign-ins |
Your account ▸ Notifications
What we tell you about, and where.
| Address | /notifications |
|---|---|
| Sections | Tell me when · How |
| Appears when | Always |
| Tools | me_notifications_read, me_preferences_set |
| Plan | Every plan |
| Who | Anyone. A guest's choices stay in the browser. |
| More | Profile, notifications and appearance |
Your account ▸ Appearance
Make instruction.md look like your brand: the theme, a colour, the corners, the type.
| Address | /settings/appearance |
|---|---|
| Sections | Theme · Language · Your brand |
| Appears when | Always |
| Tools | me_preferences_set |
| Plan | Every plan |
| Who | Anyone. Signed in, it follows you to your other devices; a guest's stays in the browser. |
| More | Profile, notifications and appearance |
Your account ▸ Privacy
What is shared about you, and your data.
| Address | /settings/privacy |
|---|---|
| Sections | What is shared · Your data |
| Appears when | Always |
| Tools | me_preferences_set, me_export, me_delete |
| Plan | Every plan |
| Who | Anyone. Signed in, Your data downloads or deletes the account; a guest's downloads or deletes what the browser keeps. |
| More | Your data: privacy switches, download, delete · Export and back up |
Your account ▸ Connected apps
Apps you signed in to with instruction.md, and what each may reach.
| Address | /settings/apps |
|---|---|
| Sections | Your apps · AI apps acting as you |
| Appears when | Always |
| Tools | me_apps_list, me_apps_activity, me_apps_grant, me_apps_revoke |
| Plan | Every plan |
| Who | Anyone signed in. |
| More | Connected apps · Sign-in, scopes and tokens |
Settings
Settings ▸ General
How the studio looks and works in this browser.
| Address | /settings/editor |
|---|---|
| Sections | Editor · For developers · This browser · Privacy |
| Appears when | Always |
| Tools | me_preferences_set, orgs_policy_get, orgs_policy_set |
| Plan | Every plan |
| Who | Anyone; the switches are yours. Developer mode for new members (the policy's developerMode) shows only to an organization's owners and admins. |
| More | Profile, notifications and appearance · Organization policy, roles and permissions |
Settings ▸ People
Who is in this organization, and what each of them can do.
| Address | /<owner>/-/settings/people |
|---|---|
| Sections | This organization · People · Invitations · Delete this organization |
| Appears when | The server lists orgs_members_list |
| Tools | orgs_get, orgs_members_list, orgs_members_update, orgs_members_remove, orgs_members_add, orgs_invitations_list, orgs_invitations_create, orgs_invitations_revoke, orgs_rename, orgs_delete |
| Plan | People who aren't guests |
| Who | Every member reads it. Owners and admins invite, change roles and remove; only an owner makes or removes an owner, renames or deletes the organization. |
| More | Invite people and choose their roles · Organization policy, roles and permissions |
Settings ▸ Workspaces
The organization's workspaces: what each holds and who sees it.
| Address | /<owner>/-/settings/workspaces |
|---|---|
| Sections | New workspace |
| Appears when | The server lists orgs_members_list |
| Tools | orgs_workspaces_list, orgs_workspaces_get, orgs_workspaces_create, orgs_workspaces_update, orgs_workspaces_delete, orgs_workspaces_roles_set, seal_workspaces_get |
| Plan | Workspaces Plans Community 1 · Pro 1 · Team unlimited · Enterprise unlimited Sealed workspaces (beta, not yet independently reviewed)Plans On Team and Enterprise |
| Who | In an organization only (a personal workspace has no row). Owners and admins create, change and delete workspaces. |
| More | Organizations and workspaces · Sealed instructions |
Settings ▸ Deployments
Agents on your machines and services: every instruction of a place, or one at a time, and the versions they run.
| Address | /<owner>/-/settings/deployments |
|---|---|
| Sections | Every instruction of a place |
| Appears when | The server lists orgs_members_list |
| Tools | deployments_list, deployments_approve, deployments_retire, deployments_rules_list, deployments_rules_get, deployments_rules_create, deployments_rules_update, deployments_rules_delete, deployments_rules_preview |
| Plan | Deployments Plans On Pro, Team, and Enterprise Deployment rulesPlans On Team and Enterprise Agents one rule may start |
| Who | Every member reads it. Owners and admins create rules and approve or retire deployments. |
| CLI | instruction agents run, instruction agents check |
| More | Deployments · Run your instructions as agents |
Settings ▸ Security
Defaults for new instructions, and the apps your people use.
| Address | /<owner>/-/settings/security |
|---|---|
| Sections | Defaults · Assistant · Apps your people use · For developers |
| Appears when | The server lists orgs_policy_get |
| Tools | orgs_policy_get, orgs_policy_set, orgs_apps_policy_get, orgs_apps_policy_set |
| Plan | Apps your people use Plans On Team and Enterprise |
| Who | Owners and admins. Other members see none of its settings: only, while Developer mode is off, the row that opens Developer. |
| More | Set your organization's rules · Organization policy, roles and permissions |
Settings ▸ Billing
Your plan, what you use, and the limits you set.
| Address | /<owner>/-/settings/billing |
|---|---|
| Sections | This period |
| Appears when | The server lists orgs_usage_get |
| Tools | orgs_usage_get, orgs_spending_set, orgs_billing_checkout, orgs_billing_portal |
| Plan | Every plan |
| Who | Every member reads the plan and the meters. Owners, admins and the billing role buy, change the plan and set the spending limit. |
| More | Plans, limits and billing · Rate and size limits |
Settings ▸ Activity
Who did what, and when — never the content.
| Address | /<owner>/-/settings/activity |
|---|---|
| Sections | Export |
| Appears when | The server lists orgs_policy_get |
| Tools | instructions_audit_query, instructions_audit_export |
| Plan | Every plan |
| Who | Owners and admins. It has no row of its own in the side bar: open its address, and Security stays marked while it is shown. |
| CLI | instruction audit |
| More | Audit trail · See who did what |
Integrations
Integrations ▸ Overview
The tools, skills and agents your instructions use, offered as you write.
| Address | /<owner>/-/settings/integrations |
|---|---|
| Sections | None: one list |
| Appears when | The server lists orgs_integrations_list |
| Tools | orgs_integrations_list |
| Plan | Adding integrations |
| Who | Every member reads it. |
| More | Integrations and tool policy (admin API) · Add the tools your agents may use |
Integrations ▸ Agents
AI agents your instructions can hand work to.
| Address | /<owner>/-/settings/integrations/agents |
|---|---|
| Sections | None: one list |
| Appears when | The server lists orgs_integrations_list |
| Tools | orgs_integrations_list, orgs_integrations_add, orgs_integrations_sync, orgs_integrations_remove, orgs_agents_list |
| Plan | Adding integrations |
| Who | Every member reads it. Owners and admins add, pull again and remove. |
| More | Integrations and tool policy (admin API) |
Integrations ▸ MCP
The registries and servers whose tools your instructions use.
| Address | /<owner>/-/settings/integrations/mcp-servers |
|---|---|
| Sections | None: one list |
| Appears when | The server lists orgs_integrations_list |
| Tools | orgs_integrations_list, orgs_integrations_add, orgs_integrations_sync, orgs_integrations_remove, orgs_integrations_tools_list, orgs_integrations_tools_set |
| Plan | Adding integrations Plans On Pro, Team, and Enterprise Allowing and blocking a server's toolsPlans On Pro, Team, and Enterprise Instructions may name only what is added herePlans On Team and Enterprise |
| Who | Every member reads it. Owners and admins add servers and registries, and allow or block tools. |
| More | Integrations and tool policy (admin API) · Servers, skills and sign-ins |
Integrations ▸ Skills
Ready-made know-how your instructions point to.
| Address | /<owner>/-/settings/integrations/skills |
|---|---|
| Sections | None: one list |
| Appears when | The server lists orgs_integrations_list |
| Tools | orgs_integrations_list, orgs_integrations_add, orgs_integrations_sync, orgs_integrations_remove |
| Plan | Adding integrations |
| Who | Every member reads it. Owners and admins add and remove. |
| More | Integrations and tool policy (admin API) |
Integrations ▸ APIs
Web services your instructions use, and which of their operations they may.
| Address | /<owner>/-/settings/integrations/apis |
|---|---|
| Sections | None: one list |
| Appears when | The server lists orgs_integrations_list |
| Tools | orgs_integrations_list, orgs_integrations_apis_add, orgs_integrations_apis_pull, orgs_integrations_remove |
| Plan | Adding integrations |
| Who | Every member reads it. Owners and admins add and pull again. |
| More | Integrations and tool policy (admin API) |
Integrations ▸ Directories
The people your instructions can name: this organization's, and those of the directories you add.
| Address | /<owner>/-/settings/integrations/directories |
|---|---|
| Sections | None: one list |
| Appears when | The server lists orgs_integrations_list |
| Tools | orgs_people_directories_list, orgs_people_directories_add, orgs_people_directories_pull, orgs_people_directories_set, orgs_scim_tokens_list, orgs_scim_tokens_create, orgs_scim_tokens_revoke |
| Plan | People directories Plans On Pro, Team, and Enterprise SCIM provisioningPlans On Team and Enterprise |
| Who | Every member reads it. Owners and admins add directories and make SCIM tokens. |
| More | SCIM and people directories · Bring in your company's people |
Developer
Developer ▸ Apps
Apps that let people sign in with instruction.md, and use their instructions elsewhere.
| Address | /<owner>/-/developer/apps |
|---|---|
| Sections | Your apps |
| Appears when | The server lists orgs_apps_list |
| Tools | orgs_apps_list, orgs_apps_create, orgs_apps_update, orgs_apps_rotate, orgs_apps_revoke, orgs_apps_review_request |
| Plan | Apps Plans Community 1 · Pro 5 · Team 25 · Enterprise unlimited Apps that follow every instruction of a workspacePlans On Team and Enterprise |
| Who | Every member reads it. Owners and admins register and change apps. |
| More | Connected apps |
Developer ▸ Domains
Your domains, proven with a DNS record: for single sign-on, and to show your apps as verified.
| Address | /<owner>/-/developer/domains |
|---|---|
| Sections | Your domains |
| Appears when | The server lists orgs_domains_list |
| Tools | orgs_domains_list, orgs_domains_add, orgs_domains_verify, orgs_domains_remove |
| Plan | Every plan |
| Who | Every member reads it. Owners and admins add, prove and remove domains. |
| More | Domains |
Developer ▸ Single sign-on
Your people sign in with your company's identity provider, and AI clients connect through it.
| Address | /<owner>/-/developer/sso |
|---|---|
| Sections | Single sign-on · AI clients |
| Appears when | The server lists orgs_signin_get |
| Tools | orgs_signin_get, orgs_signin_set, orgs_signin_provider_save, orgs_signin_provider_remove, orgs_signin_domains_add, orgs_signin_domains_verify, orgs_signin_domains_remove |
| Plan | Single sign-on Plans On Enterprise AI clients connected through your identity providerPlans On Enterprise |
| Who | Owners and admins; anyone else sees that it is theirs to set up. |
| More | Company sign-in (single sign-on) · Domains |
Developer ▸ API keys
Sign-ins of their own for the agents that read this organization's instructions.
| Address | /<owner>/-/developer/agents |
|---|---|
| Sections | Agents |
| Appears when | The server lists orgs_agents_list |
| Tools | orgs_agents_list, orgs_agents_create, orgs_agents_rotate, orgs_agents_revoke |
| Plan | Agent credentials Plans On Pro, Team, and Enterprise Agent credentials that aren't revoked |
| Who | Every member reads it. Owners and admins create, rotate and revoke. |
| CLI | instruction agents |
| More | Agent credentials and CI tokens |
Developer ▸ Signing
The keys your versions are signed with, and whether refs move only to signed versions.
| Address | /<owner>/-/developer/signing |
|---|---|
| Sections | Signed versions · Signing keys |
| Appears when | The server lists orgs_keys_add |
| Tools | orgs_keys_list, orgs_keys_add, orgs_keys_rotate, orgs_keys_retire, orgs_keys_revoke, orgs_policy_set |
| Plan | Signing Plans On every plan |
| Who | Every member reads the keys. Owners and admins add, rotate, retire and revoke them, and choose whether refs move only to signed versions. |
| CLI | instruction keygen, instruction keys |
| More | Signing and trust |
Every path, as pages write it
Pages of these docs and of Learn write a setting as its bold ▸ path: the group, the page, and where it helps the section. These are all the paths the editor has today, read from the same code as the map above. A path that isn't in this list doesn't exist in the editor. This list is the source for a check of the bold ▸ paths on every page; that check doesn't run in the docs build yet, so a reviewer compares paths with this list by hand.
- Your account ▸ Profile
- Your account ▸ Profile ▸ About you
- Your account ▸ Profile ▸ Where you are
- Your account ▸ Security
- Your account ▸ Security ▸ Passkeys
- Your account ▸ Security ▸ Recovery codes
- Your account ▸ Security ▸ Signed in with
- Your account ▸ Security ▸ Where you're signed in
- Your account ▸ Security ▸ Your profile
- Your account ▸ Notifications
- Your account ▸ Notifications ▸ Tell me when
- Your account ▸ Notifications ▸ How
- Your account ▸ Appearance
- Your account ▸ Appearance ▸ Theme
- Your account ▸ Appearance ▸ Language
- Your account ▸ Appearance ▸ Your brand
- Your account ▸ Privacy
- Your account ▸ Privacy ▸ What is shared
- Your account ▸ Privacy ▸ Your data
- Your account ▸ Connected apps
- Your account ▸ Connected apps ▸ Your apps
- Your account ▸ Connected apps ▸ AI apps acting as you
- Settings ▸ General
- Settings ▸ General ▸ Editor
- Settings ▸ General ▸ For developers
- Settings ▸ General ▸ This browser
- Settings ▸ General ▸ Privacy
- Settings ▸ People
- Settings ▸ People ▸ This organization
- Settings ▸ People ▸ Invitations
- Settings ▸ People ▸ Delete this organization
- Settings ▸ Workspaces
- Settings ▸ Workspaces ▸ New workspace
- Settings ▸ Deployments
- Settings ▸ Deployments ▸ Every instruction of a place
- Settings ▸ Security
- Settings ▸ Security ▸ Defaults
- Settings ▸ Security ▸ Assistant
- Settings ▸ Security ▸ Apps your people use
- Settings ▸ Security ▸ For developers
- Settings ▸ Billing
- Settings ▸ Billing ▸ This period
- Settings ▸ Activity
- Settings ▸ Activity ▸ Export
- Integrations ▸ Overview
- Integrations ▸ Agents
- Integrations ▸ MCP
- Integrations ▸ Skills
- Integrations ▸ APIs
- Integrations ▸ Directories
- Developer ▸ Apps
- Developer ▸ Apps ▸ Your apps
- Developer ▸ Domains
- Developer ▸ Domains ▸ Your domains
- Developer ▸ Single sign-on
- Developer ▸ Single sign-on ▸ AI clients
- Developer ▸ API keys
- Developer ▸ API keys ▸ Agents
- Developer ▸ Signing
- Developer ▸ Signing ▸ Signed versions
- Developer ▸ Signing ▸ Signing keys
If a page is missing
| What you see | Why | What to do |
|---|---|---|
| No Developer group in the side bar | Developer mode is off | Turn it on in Settings ▸ General |
| No Workspaces row under Settings | The workspace you have open is your personal one | Switch to an organization in the switcher at the top of the side bar |
| Settings ▸ Security shows no settings, or only Open Developer | You aren't an owner or admin of the organization | Ask one of them. Who has which role |
| No Security in the Your account menu | The editor's access token isn't for the sign-in service's account API: its audience lacks account. A self-hosted realm that doesn't give the editor's client the imd-account scope never shows it |
On instruction.md, sign out and sign in again in the editor. Self-hosted, add the scope to the editor's client in the realm. An AI app's or the CLI's token never opens this page |
| An address shows the not-found view | The organization in the address isn't one of yours, or the server has no tool for that page | Check the URL name in the address, and that you are signed in as the right person |
| A row shows a plan badge instead of its controls | The organization's plan doesn't include it | See Plans, limits and billing |
| Single sign-on says it is for owners and admins | Only they set up the organization's sign-in | Ask an owner or admin |