Skip to main content

Connecting MCP Servers

Connect the Skill Manager MCP server to your Claude surface. Covers the marketplace connector approach for Cowork, Claude Code, and claude.ai.

The Skill Manager is the MCP server that connects Claude to your systemprompt.io workspace. It provides live tools for creating, editing, and analysing skills, and ensures your conversations are tracked in the Control Center.

Note: The Skill Manager is not the primary way skills reach Claude. Your skills are delivered locally through your personal marketplace. The Skill Manager connection adds live editing, analytics, and conversation tracking on top. If you have not installed the marketplace yet, start with the Installation Guide.

For complete setup instructions covering all three Claude surfaces, see Connecting Claude to systemprompt.io.

Cowork (Claude Desktop)

The recommended approach uses the marketplace connector that comes bundled with your marketplace installation.

  1. Install your personal marketplace first (see Installation Guide, Step 2)
  2. In Claude Desktop, go to Customize > Personal plugins > Systemprompt > Connectors
  3. Find the Skill Manager connector and click Connect
  4. A browser window will open — log in with your systemprompt.io account to authorise

What the Skill Manager adds

The Skill Manager provides Claude with live tools to:

  • Create and update skills — build new skills or refine existing ones without leaving your conversation
  • Analyse skill usage — see which skills are effective and which need improvement
  • Manage agents and secrets — configure agents and store API keys securely
  • Track conversations — every conversation appears in your Control Center with analytics

Without the Skill Manager, your skills still work (they are local files from the marketplace). With it, you get the full experience: live editing, analytics, and conversation tracking.

Claude Code

After importing the plugin (export ZIP from My Marketplace, then import in Claude Code), connect the Skill Manager connector:

  1. Go to Customize > Personal plugins > Systemprompt > Connectors
  2. Find the Skill Manager connector and click Connect
  3. Follow the OAuth flow in your browser to authorise

claude.ai

On claude.ai, the Skill Manager connects as a remote MCP integration:

  1. Go to Settings > Integrations and click Add more
  2. Enter: https://systemprompt.io/api/v1/mcp/skill-manager/mcp
  3. Authorise with your systemprompt.io account

Alternative: Manual configuration

For advanced users, you can add the Skill Manager directly to the Claude Desktop configuration file:

  1. In Claude Desktop, go to Settings > Developer > Edit Config
  2. Add the systemprompt entry to the mcpServers section:
{
  "mcpServers": {
    "systemprompt": {
      "url": "https://systemprompt.io/api/v1/mcp/skill-manager/mcp"
    }
  }
}
  1. Save the file and restart Claude Desktop
  2. Authenticate when prompted in your browser

Connection details

Setting Value
Endpoint URL https://systemprompt.io/api/v1/mcp/skill-manager/mcp
Protocol MCP over HTTPS (Streamable HTTP)
Authentication OAuth (automatic via browser)

Refreshing the connection

When you make changes in your systemprompt.io dashboard — such as adding a new skill, installing a plugin, or modifying an agent — start a new conversation to see the updates. Each new conversation re-fetches the available tools from the Skill Manager.

You do not need to restart Claude Desktop or re-authenticate when your workspace changes.

Troubleshooting

Tools do not appear after connecting

  • Verify that systemprompt.io and *.systemprompt.io are in your domain allowlist (see Connecting Claude)
  • Start a new conversation — tools load at conversation start
  • Verify your workspace has content at systemprompt.io/admin

Authentication prompt does not appear

  • Make sure your default browser is not blocking pop-ups from systemprompt.io
  • Try clearing your browser cookies for systemprompt.io and restarting Claude Desktop

Connection drops or times out

  • Check your internet connection — the Skill Manager is a remote server
  • If behind a corporate firewall, ensure systemprompt.io is not blocked
  • Try disconnecting and reconnecting the connector

Tools appear but do not work

  • Check that the skills or plugins associated with the tools are properly configured
  • Verify your systemprompt.io account is active
  • Try re-authenticating by disconnecting and reconnecting the connector

Next steps