Skip to content
PerSQL PerSQL PerSQL

Install for Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows:

{
  "mcpServers": {
    "persql": {
      "url": "https://mcp.persql.com"
    }
  }
}

Restart Claude Desktop. The first tool call opens the browser to console.persql.com/oauth-consent — pick a namespace and approve. Tools appear under the plug icon at the bottom-left of the input bar.

Bearer fallback

Section titled “Bearer fallback”

If your Claude Desktop build doesn’t yet support MCP OAuth, pass a token from console.persql.com → API tokens as a header:

{
  "mcpServers": {
    "persql": {
      "url": "https://mcp.persql.com",
      "headers": {
        "Authorization": "Bearer psql_live_…"
      }
    }
  }
}

Verify

Section titled “Verify”

Click the plug icon. You should see persql listed with a tool count. Try asking: “List my PerSQL databases.”

What you get

Section titled “What you get”

About sixty SQL-shaped tools — query, batch, schema introspection, branches, snapshots, schedules, webhooks, and self-funding. The full list is in the MCP reference.