Skip to main content

Connecting to Claude Desktop

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

Prerequisites​

Step 1: Locate Your Config File​

Claude Desktop stores its configuration in a JSON file. The location depends on your operating system:

macOS​

~/Library/Application Support/Claude/claude_desktop_config.json

Windows​

%APPDATA%\Claude\claude_desktop_config.json

Linux​

~/.config/Claude/claude_desktop_config.json
tip

If the file doesn't exist, you may need to create it. Make sure to create the parent directories as well.

Step 2: Add Promptsy Server​

Open the config file in a text editor and add the Promptsy MCP server:

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

If you already have other MCP servers configured, add Promptsy alongside them:

claude_desktop_config.json
{
  "mcpServers": {
    "other-server": {
      "url": "https://other-server.example.com/mcp"
    },
    "promptsy": {
      "url": "https://mcp.promptsy.dev/mcp"
    }
  }
}

Step 3: Restart Claude Desktop​

For the changes to take effect:

  1. Completely quit Claude Desktop (not just close the window)
  2. Reopen Claude Desktop

Step 4: Authorize Promptsy​

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

  1. Ask Claude to "show my prompts" or similar
  2. A popup will appear asking you to authorize
  3. Click the authorization link
  4. You'll be redirected to Promptsy's consent screen
  5. Review the permissions and click Approve
  6. Return to Claude Desktop

Permissions Explained​

When authorizing, you'll see these scopes:

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

Step 5: Start Using Promptsy​

You're all set! Try these commands:

Browse Your Prompts​

"Show me my prompts"

Claude will display an interactive browser with your prompts. You can:

  • Click prompts to expand them
  • Copy prompts to clipboard
  • See variable counts

Search Your Vault​

"Find my prompts about coding"

Claude will search your vault and show matching results.

Save a New Prompt​

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

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

Search Public Prompts​

"Search public prompts for blog writing"

No authentication needed - browse the Promptsy community.

Troubleshooting​

Tools not appearing​

  1. Make sure the config file is valid JSON
  2. Check the file location is correct for your OS
  3. Completely restart Claude Desktop (quit and reopen)

Authorization popup not showing​

Try asking Claude: "Use the Promptsy browse_prompts tool"

"Not authorized" error​

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

Config file syntax error​

Use a JSON validator like jsonlint.com to check your config file.

Revoking Access​

To disconnect Promptsy from Claude:

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

Next Steps​