Skip to main content
Section navigation

Connecting Claude to systemprompt.io

Connect your Claude surface to systemprompt.io so skills, plugins, and analytics work. Covers Cowork, Claude Code, and claude.ai with step-by-step instructions.

On this page

Everything on the systemprompt platform — skills, plugins, agents, analytics — depends on a live connection between Claude and systemprompt.io. Without it, Claude cannot see your skills, your conversations are not tracked, and the platform has no value.

Choose the Claude surface you use most and follow the instructions below.

Prerequisites

Before you begin, you need:

  1. A systemprompt.io account. Create one at systemprompt.io if you have not already. Registration uses WebAuthn (fingerprint, face, or security key). No passwords.

  2. A Claude account. You need a Claude Pro, Team, or Enterprise account. The specific requirements depend on which surface you use.

Option A: Connect via Cowork (Claude Desktop)

Cowork is the desktop application for Claude. This is the recommended option if you primarily use Claude through the desktop app.

For the complete Cowork walkthrough including domain whitelisting, marketplace installation, Skill Manager connection, global instructions, and onboarding, see the Installation Guide.

The Installation Guide covers five steps:

  1. Whitelist systemprompt.io in Claude Desktop
  2. Install your personal marketplace
  3. Connect the Skill Manager connector
  4. Add global instructions
  5. Run the /onboarding assistant

Option B: Connect via Claude Code

Claude Code is the CLI tool for working with Claude in your terminal.

Step 1: Whitelist systemprompt.io

Open Claude Desktop and go to Settings > Capabilities > Code execution and file creation.

  1. Enable Allow network egress
  2. Set the domain allowlist to Package managers only
  3. Add these two domains:
Domain Purpose
systemprompt.io Main API and dashboard
*.systemprompt.io Tenant subdomains

Step 2: Install the marketplace

Open your terminal and run the install command. You can find your personal install command on the Control Center page. It looks like this:

/plugin marketplace add https://systemprompt.io/api/public/marketplace/YOUR-USER-ID.git

This installs your personal marketplace — a git repository containing all your plugins, skills, agents, and slash commands. Claude Code now has a local copy of everything and your skills work immediately.

Step 3: Connect the Skill Manager

After installing the marketplace, connect the Skill Manager connector for live management and analytics. Go to Customize > Personal plugins > Systemprompt > Connectors. Find the Skill Manager connector and click Connect.

Claude Code will prompt you to authenticate with your systemprompt.io account. Follow the OAuth flow in your browser to authorise the connection.

The marketplace delivers your skills locally. The Skill Manager connection adds the ability to create, edit, and analyse skills in real-time, and ensures your conversations are tracked in the Control Center. Both are needed for the full experience.

Option C: Connect via claude.ai

claude.ai is the web interface for Claude. This is the simplest setup option — just two steps.

Step 1: Add remote MCP integration

On claude.ai, go to Settings > Integrations and click Add more.

Enter this URL as a custom integration:

https://systemprompt.io/api/v1/mcp/skill-manager/mcp

Step 2: Authorise and use

When prompted, authorise with your systemprompt.io account. Your skills, agents, and tools will then be available in claude.ai conversations.

Events will appear in your Control Center automatically.

Verify your connection

After setting up any surface, verify that the connection is working. Start a new conversation with Claude and ask:

"What systemprompt.io skills do I have available?"

Claude should respond with a list of your skills. If you have not created any skills yet, Claude should at least confirm that the systemprompt.io plugin is connected.

Additional verification checks

  • Plugin connection: Ask Claude "What plugins are active in this conversation?" and confirm systemprompt.io appears
  • MCP tools: Ask Claude to use the list_skills tool to show your skill library
  • Control Center: Visit your Control Center and check that the conversation appears in the live feed

Troubleshooting

Plugin not appearing after installation

  1. Refresh your browser or restart Claude Desktop
  2. Sign out of Claude and sign back in to force a fresh session
  3. Check your account plan — marketplace access requires a Pro or Team plan
  4. If you are on a Team plan, check with your administrator that Cowork is enabled for your seat

Authorisation failed

  1. Check that your systemprompt.io account is active at systemprompt.io/admin
  2. Clear your browser cookies for claude.ai and systemprompt.io, then retry
  3. If you are on a corporate network, check whether your firewall blocks the OAuth redirect
  4. Try a private/incognito browser window to rule out extension interference

Connection established but skills not visible

  1. Start a new conversation. Skills load at the start of a conversation, so mid-conversation changes will not appear
  2. Check that your skills are saved on systemprompt.io — draft skills are not delivered
  3. Verify you are logged in to the same systemprompt.io account that the plugin is authorised with

Claude Code connection issues

  1. Run claude --version and update if needed
  2. Run claude mcp list to check configured servers
  3. If the server shows an error, remove and re-add it: claude mcp remove systemprompt then re-run the add command
  4. Check your network connection — the server requires HTTPS access to systemprompt.io

What happens after connection

Once connected, systemprompt.io is live. Every conversation you have with Claude is tracked, analysed, and enriched with your custom skills. Your Control Center becomes the hub for monitoring how you use Claude.

Next steps