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:

  • /settings opens 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/registries opens 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
SectionsAbout you · Where you are
Appears whenAlways
Toolsme_profile_update, me_preferences_set
PlanEvery plan
WhoAnyone signed in. A guest is asked to sign in.
CLIinstruction whoami
MoreProfile, notifications and appearance

Your account ▸ Security

How you sign in, and where you're signed in.

Address/settings/sign-in
SectionsPasskeys · Recovery codes · Signed in with · Where you're signed in · Your profile
Appears whenWhen 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
ToolsNone. It reads and changes your account in the sign-in service directly
PlanEvery plan
WhoAnyone 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.
MorePasskeys · Recovery codes · Your devices and linked sign-ins

Your account ▸ Notifications

What we tell you about, and where.

Address/notifications
SectionsTell me when · How
Appears whenAlways
Toolsme_notifications_read, me_preferences_set
PlanEvery plan
WhoAnyone. A guest's choices stay in the browser.
MoreProfile, notifications and appearance

Your account ▸ Appearance

Make instruction.md look like your brand: the theme, a colour, the corners, the type.

Address/settings/appearance
SectionsTheme · Language · Your brand
Appears whenAlways
Toolsme_preferences_set
PlanEvery plan
WhoAnyone. Signed in, it follows you to your other devices; a guest's stays in the browser.
MoreProfile, notifications and appearance

Your account ▸ Privacy

What is shared about you, and your data.

Address/settings/privacy
SectionsWhat is shared · Your data
Appears whenAlways
Toolsme_preferences_set, me_export, me_delete
PlanEvery plan
WhoAnyone. Signed in, Your data downloads or deletes the account; a guest's downloads or deletes what the browser keeps.
MoreYour 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
SectionsYour apps · AI apps acting as you
Appears whenAlways
Toolsme_apps_list, me_apps_activity, me_apps_grant, me_apps_revoke
PlanEvery plan
WhoAnyone signed in.
MoreConnected apps · Sign-in, scopes and tokens

Settings

Settings ▸ General

How the studio looks and works in this browser.

Address/settings/editor
SectionsEditor · For developers · This browser · Privacy
Appears whenAlways
Toolsme_preferences_set, orgs_policy_get, orgs_policy_set
PlanEvery plan
WhoAnyone; the switches are yours. Developer mode for new members (the policy's developerMode) shows only to an organization's owners and admins.
MoreProfile, 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
SectionsThis organization · People · Invitations · Delete this organization
Appears whenThe server lists orgs_members_list
Toolsorgs_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
PlanPeople who aren't guests

Plans Community 3 · Pro 1 · Team 10 · Enterprise unlimited

WhoEvery member reads it. Owners and admins invite, change roles and remove; only an owner makes or removes an owner, renames or deletes the organization.
MoreInvite 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
SectionsNew workspace
Appears whenThe server lists orgs_members_list
Toolsorgs_workspaces_list, orgs_workspaces_get, orgs_workspaces_create, orgs_workspaces_update, orgs_workspaces_delete, orgs_workspaces_roles_set, seal_workspaces_get
PlanWorkspaces

Plans Community 1 · Pro 1 · Team unlimited · Enterprise unlimited

Sealed workspaces (beta, not yet independently reviewed)

Plans On Team and Enterprise

WhoIn an organization only (a personal workspace has no row). Owners and admins create, change and delete workspaces.
MoreOrganizations 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
SectionsEvery instruction of a place
Appears whenThe server lists orgs_members_list
Toolsdeployments_list, deployments_approve, deployments_retire, deployments_rules_list, deployments_rules_get, deployments_rules_create, deployments_rules_update, deployments_rules_delete, deployments_rules_preview
PlanDeployments

Plans On Pro, Team, and Enterprise

Deployment rules

Plans On Team and Enterprise

Agents one rule may start

Plans Team 50 · Enterprise unlimited

WhoEvery member reads it. Owners and admins create rules and approve or retire deployments.
CLIinstruction agents run, instruction agents check
MoreDeployments · Run your instructions as agents

Settings ▸ Security

Defaults for new instructions, and the apps your people use.

Address/<owner>/-/settings/security
SectionsDefaults · Assistant · Apps your people use · For developers
Appears whenThe server lists orgs_policy_get
Toolsorgs_policy_get, orgs_policy_set, orgs_apps_policy_get, orgs_apps_policy_set
PlanApps your people use

Plans On Team and Enterprise

WhoOwners and admins. Other members see none of its settings: only, while Developer mode is off, the row that opens Developer.
MoreSet 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
SectionsThis period
Appears whenThe server lists orgs_usage_get
Toolsorgs_usage_get, orgs_spending_set, orgs_billing_checkout, orgs_billing_portal
PlanEvery plan
WhoEvery member reads the plan and the meters. Owners, admins and the billing role buy, change the plan and set the spending limit.
MorePlans, limits and billing · Rate and size limits

Settings ▸ Activity

Who did what, and when — never the content.

Address/<owner>/-/settings/activity
SectionsExport
Appears whenThe server lists orgs_policy_get
Toolsinstructions_audit_query, instructions_audit_export
PlanEvery plan
WhoOwners and admins. It has no row of its own in the side bar: open its address, and Security stays marked while it is shown.
CLIinstruction audit
MoreAudit trail · See who did what

Integrations

Integrations ▸ Overview

The tools, skills and agents your instructions use, offered as you write.

Address/<owner>/-/settings/integrations
SectionsNone: one list
Appears whenThe server lists orgs_integrations_list
Toolsorgs_integrations_list
PlanAdding integrations

Plans On Pro, Team, and Enterprise

WhoEvery member reads it.
MoreIntegrations 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
SectionsNone: one list
Appears whenThe server lists orgs_integrations_list
Toolsorgs_integrations_list, orgs_integrations_add, orgs_integrations_sync, orgs_integrations_remove, orgs_agents_list
PlanAdding integrations

Plans On Pro, Team, and Enterprise

WhoEvery member reads it. Owners and admins add, pull again and remove.
MoreIntegrations and tool policy (admin API)

Integrations ▸ MCP

The registries and servers whose tools your instructions use.

Address/<owner>/-/settings/integrations/mcp-servers
SectionsNone: one list
Appears whenThe server lists orgs_integrations_list
Toolsorgs_integrations_list, orgs_integrations_add, orgs_integrations_sync, orgs_integrations_remove, orgs_integrations_tools_list, orgs_integrations_tools_set
PlanAdding integrations

Plans On Pro, Team, and Enterprise

Allowing and blocking a server's tools

Plans On Pro, Team, and Enterprise

Instructions may name only what is added here

Plans On Team and Enterprise

WhoEvery member reads it. Owners and admins add servers and registries, and allow or block tools.
MoreIntegrations 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
SectionsNone: one list
Appears whenThe server lists orgs_integrations_list
Toolsorgs_integrations_list, orgs_integrations_add, orgs_integrations_sync, orgs_integrations_remove
PlanAdding integrations

Plans On Pro, Team, and Enterprise

WhoEvery member reads it. Owners and admins add and remove.
MoreIntegrations and tool policy (admin API)

Integrations ▸ APIs

Web services your instructions use, and which of their operations they may.

Address/<owner>/-/settings/integrations/apis
SectionsNone: one list
Appears whenThe server lists orgs_integrations_list
Toolsorgs_integrations_list, orgs_integrations_apis_add, orgs_integrations_apis_pull, orgs_integrations_remove
PlanAdding integrations

Plans On Pro, Team, and Enterprise

WhoEvery member reads it. Owners and admins add and pull again.
MoreIntegrations 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
SectionsNone: one list
Appears whenThe server lists orgs_integrations_list
Toolsorgs_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
PlanPeople directories

Plans On Pro, Team, and Enterprise

SCIM provisioning

Plans On Team and Enterprise

WhoEvery member reads it. Owners and admins add directories and make SCIM tokens.
MoreSCIM 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
SectionsYour apps
Appears whenThe server lists orgs_apps_list
Toolsorgs_apps_list, orgs_apps_create, orgs_apps_update, orgs_apps_rotate, orgs_apps_revoke, orgs_apps_review_request
PlanApps

Plans Community 1 · Pro 5 · Team 25 · Enterprise unlimited

Apps that follow every instruction of a workspace

Plans On Team and Enterprise

WhoEvery member reads it. Owners and admins register and change apps.
MoreConnected 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
SectionsYour domains
Appears whenThe server lists orgs_domains_list
Toolsorgs_domains_list, orgs_domains_add, orgs_domains_verify, orgs_domains_remove
PlanEvery plan
WhoEvery member reads it. Owners and admins add, prove and remove domains.
MoreDomains

Developer ▸ Single sign-on

Your people sign in with your company's identity provider, and AI clients connect through it.

Address/<owner>/-/developer/sso
SectionsSingle sign-on · AI clients
Appears whenThe server lists orgs_signin_get
Toolsorgs_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
PlanSingle sign-on

Plans On Enterprise

AI clients connected through your identity provider

Plans On Enterprise

WhoOwners and admins; anyone else sees that it is theirs to set up.
MoreCompany 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
SectionsAgents
Appears whenThe server lists orgs_agents_list
Toolsorgs_agents_list, orgs_agents_create, orgs_agents_rotate, orgs_agents_revoke
PlanAgent credentials

Plans On Pro, Team, and Enterprise

Agent credentials that aren't revoked

Plans Pro 10 · Team 100 · Enterprise unlimited

WhoEvery member reads it. Owners and admins create, rotate and revoke.
CLIinstruction agents
MoreAgent 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
SectionsSigned versions · Signing keys
Appears whenThe server lists orgs_keys_add
Toolsorgs_keys_list, orgs_keys_add, orgs_keys_rotate, orgs_keys_retire, orgs_keys_revoke, orgs_policy_set
PlanSigning

Plans On every plan

WhoEvery member reads the keys. Owners and admins add, rotate, retire and revoke them, and choose whether refs move only to signed versions.
CLIinstruction keygen, instruction keys
MoreSigning 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

Last checked against the product:

Was this page helpful? Report a problem