Skip to main content

Connecting to Claude Code

Connect your Promptsy vault to Claude Code to browse, search, and save prompts directly in your terminal conversations.

Prerequisites​

  • Claude Code CLI installed
  • A Promptsy account (any tier)

Add Promptsy Server​

Add the Promptsy MCP server to your Claude Code configuration. You can do this via the settings command or by editing your config file directly.

Option 1: Using CLI Command​

Run the following command to add Promptsy as an HTTP MCP server:

claude mcp add --transport http promptsy https://mcp.promptsy.dev/mcp
tip

The --transport http (or -t http) flag is required for remote HTTP MCP servers.

Option 2: Edit Config File​

Add Promptsy to your MCP configuration file:

{
  "mcpServers": {
    "promptsy": {
      "url": "https://mcp.promptsy.dev/mcp"
    }
  }
}

Authorize Promptsy​

The first time you use a Promptsy tool, you'll need to authorize access:

  1. Ask Claude Code to "show my prompts" or use any Promptsy tool
  2. A link will appear asking you to authorize
  3. Click the link to open Promptsy in your browser
  4. Review the permissions and click Approve
  5. Return to Claude Code

Permissions​

When authorizing, you'll grant these scopes:

ScopeWhat it allows
prompts:readView your prompts and collections
prompts:writeCreate and save prompts
account:readView your account tier and credits

Start Using Promptsy​

You're all set! Try these commands:

Browse Your Prompts​

"Show me my prompts"

Claude Code will display your prompts with options to copy or expand them.

Save a New Prompt​

"Save this as a prompt called 'Code Reviewer' with category 'coding'"

Claude Code will save the prompt to your vault and confirm with a link.

Search Public Prompts​

"Search public prompts for debugging"

Browse the Promptsy community without authentication.

Available Tools​

ToolDescriptionAuth Required
browse_promptsBrowse your personal prompt libraryYes
save_promptSave a new prompt to your vaultYes
search_public_promptsSearch the public prompt communityNo

Troubleshooting​

Tools not appearing​

  1. Restart Claude Code after adding the server
  2. Verify the URL is correct: https://mcp.promptsy.dev/mcp

Authorization failed​

  1. Make sure you're logged into Promptsy in your browser
  2. Try the authorization flow again

"Not authorized" error​

  1. Go to promptsy.dev/settings
  2. Check "Connected Apps" section
  3. Revoke and re-authorize if needed

Revoking Access​

To disconnect Promptsy from Claude Code:

  1. Go to promptsy.dev/settings
  2. Find Claude Code in "Connected Apps"
  3. Click Revoke Access

Next Steps​