Back to blog
5 min read

Manage your system prompts from Claude Code

Connect SuperPrompts to Claude Code with one command, then let your agent read, edit and publish system prompts — every change versioned and attributable.

mcpclaudeguideprompt-management

Your team has a system prompt that drives a customer-facing model. It works well, but the marketing copy in the onboarding section is stale. You want to update it, and you want your agent to do the same work going forward without you having to open a terminal and edit files.

SuperPrompts has an MCP server for this exact use case. Connect it to Claude Code with one command, and your agent can list projects, read prompts, edit them, publish new versions and roll back — all from the same terminal you're already using. Every change lands in version history with a commit message and the client that made it, so you always know who changed what.

Here is the full loop: connect, edit, verify the agent's change, roll back if needed.

Step 1: Connect the MCP server

SuperPrompts exposes a hosted MCP server at https://superprompts.app/api/v2/mcp. It uses Streamable HTTP transport and supports both OAuth (for interactive sessions) and project API keys (for headless use).

In Claude Code, add it with one command:

claude mcp add --transport http superprompts https://superprompts.app/api/v2/mcp

After running that, Claude Code will prompt you to sign in to SuperPrompts. You'll see a consent screen listing your account, organization and the scope: full access to every project in the org, including future ones. Read, create, update and publish prompts. Approve and you're done.

Prefer a project API key? It lives in Project → Settings → API and reaches exactly one project. The same MCP endpoint accepts either OAuth or a key — the choice is about scope, not configuration.

Step 2: The agent reads your prompts

Once connected, you don't need to name any tools. You ask for what you want and the client picks. Here is the first conversation:

> What projects and prompts do I have?
 
  list_projects   -> Customer Support, Internal Tools
  list_prompts    -> Support Agent (production 38e8675), Onboarding (production a1b2c3d)
  get_prompt      -> Support Agent, version "production"
                    sections: role, tone, task_rules, examples
                    variables: { customer }

The response includes the assembled prompt text, its named sections, template variables and any function-calling tools. You can ask Claude to compile the variables with real values so you can see what the model actually receives.

Step 3: The agent edits and publishes

Now update the stale marketing copy:

> The onboarding section of the Support Agent prompt still says
  "We're a startup." Change it to "We serve 10,000+ businesses worldwide,"
  and publish it.
 
  get_prompt      -> Support Agent (current production 38e8675)
  update_prompt   -> version 4f2a91c
                     section "onboarding" updated:
                     - "We're a startup."
                     + "We serve 10,000+ businesses worldwide."
  publish_prompt  -> production is now 4f2a91c (was 38e8675)
                     commit message: "Update onboarding marketing copy"

The agent reads the current production version, rewrites the onboarding section, saves a new version and publishes it. Your app picks up the new wording on its next request — no redeploy.

Every change lands in Settings → Activity with the actor (your API key or your Claude Code session), the tool used, the version before and after, and the IP address. Prompt content is never stored in the audit log.

Step 4: One-click rollback

If the change causes regressions, rolling back is just as simple:

> That change made the support agent too salesy. Roll back to the
  previous production version.
 
  get_prompt      -> Support Agent, version "production" (4f2a91c)
  get_prompt      -> Support Agent, version 38e8675 (previous production)
  publish_prompt  -> production is now 38e8675 (was 4f2a91c)
                     commit message: "Revert onboarding copy change"

Every save is a version. Rollback is just publishing an earlier version as production. Nothing is deleted, and the version you rolled back from stays in the history. The agent's name and client are recorded for every version, so you can see at a glance whether a change came from you, Claude Code, Cursor or an API key.

What the agent can do

The MCP server exposes six tools:

  • list_projects — your projects and their API key status
  • list_prompts — prompts within a project, with production and latest version
  • get_prompt — the full prompt with sections, variables and tools
  • create_prompt — create a new prompt from sections or markdown, optionally publishing the first version as production
  • update_prompt — modify sections, variables or tools and save as a new version
  • publish_prompt — promote any version to production

Changes made this way land in the same version history as edits you make in the dashboard. Same commit messages, same diffs, same rollback. The only difference is who made the change: the History view names the client (Claude Code, Cursor, API key).

Knowing what happened

The agent has the ability to publish to production, so paper trails matter. Settings → Activity lists every action from the dashboard, the API and MCP. Each entry shows who did it, which app they did it through, what changed, the version before and after, and the IP address. Entries are kept for 90 days.

Settings → Connected apps lists every app you've approved. Revoke with one click, and access stops within about a minute.

Try it

Add the MCP server, ask Claude Code to list your prompts, and have it make a small edit. Check Activity afterward to see what it recorded. If something looks off, roll back and revoke.

The free plan includes the MCP server and the connector. No card required.

The MCP docs cover each client setup. If you don't have an account yet, sign up.

Start managing your prompts with SuperPrompts

Version control, REST API access, npm package integration, and built-in prompt security. Free to get started.

Get Started Free