Skip to main content

​
Connect from this page

Use the action button below to connect SolvaPay MCP with the correct endpoint. OAuth-capable clients (Claude.ai, Claude Desktop) handle authentication automatically — just log in with your SolvaPay account. Config-based clients (Cursor, VS Code) require an API key from SolvaPay Console > Settings > API Keys.

​
Cursor IDE

  1. Open Connect SolvaPay MCP and select Install in Cursor.
  2. Enter your API key when prompted, or continue with YOUR_API_KEY_HERE.
  3. Confirm the install prompt in Cursor.
  4. If you installed with the placeholder key, update X-API-Key in Cursor MCP settings.
  5. Reload or toggle the SolvaPay MCP server in Cursor settings.
After setup, you should see SolvaPay tools available in Cursor chat.

​
VS Code

  1. Open Connect SolvaPay MCP and select Copy VS Code config.
  2. Paste into .vscode/mcp.json (workspace) or your user mcp.json.
  3. Replace YOUR_API_KEY_HERE with your SolvaPay API key.
  4. Run MCP: List Servers and start the solvapay server if needed.
  5. Reload VS Code if tools do not appear immediately.
After setup, SolvaPay tools are available in Copilot Chat.

​
Claude.ai (Web & Mobile)

SolvaPay can be added as a connector directly inside Claude.ai — no local configuration or API keys needed.
  1. Go to Settings > Connectors in Claude.ai.
  2. Click Add and enter the MCP server URL: 
    https://mcp.solvapay.com/mcp
  3. Click Add custom connector. Claude will redirect you to the SolvaPay login page.
  4. Sign in with your SolvaPay provider account (email code, Google, or GitHub).
  5. Review the permissions and click Authorize.
  6. The connector is now active. Enable it in any conversation via the + button > Connectors.
OAuth is handled automatically — Claude securely stores the access token so you don’t need to re-authorize each session. Only existing SolvaPay providers can connect; no new account is created during this flow.

​
Claude Desktop

Use Connect SolvaPay MCP and select Copy Claude Desktop config. Paste it into:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Then replace YOUR_API_KEY_HERE with your SolvaPay API key. Restart Claude Desktop after saving.

​
Claude API (Messages API)

When using Claude’s Messages API with the MCP connector beta, pass your SolvaPay API key or a provider JWT as the authorization_token: 
{
  "mcp_servers": [
    {
      "type": "url",
      "url": "https://mcp.solvapay.com/mcp",
      "name": "solvapay",
      "authorization_token": "sk_sandbox_your_key_here"
    }
  ],
  "tools": [
    {
      "type": "mcp_toolset",
      "mcp_server_name": "solvapay"
    }
  ]
}
This requires the beta header anthropic-beta: mcp-client-2025-11-20. The API does not use the browser-based OAuth flow — pass the token directly.

​
OpenClaw Gateway

Use the @solvapay/openclaw plugin to add payment tools to your OpenClaw gateway. Your AI agent can then manage SolvaPay through WhatsApp, Telegram, Discord, and any other connected channel. Install and configure it with the plugin README: See the plugin README for full configuration options, troubleshooting, and development setup.

​
Other MCP Clients

The SolvaPay MCP Server uses Streamable HTTP. Any MCP client that supports this transport can connect. Use Connect SolvaPay MCP and select Copy MCP endpoint, then configure your client with:
PropertyValue
Endpointhttps://mcp.solvapay.com/mcp
TransportStreamable HTTP (stateless)
AuthenticationOAuth 2.0 (browser-based clients) or X-API-Key header (config-based clients)

​
Using Multiple Environments

Create separate MCP server entries in your client:
  • solvapay-sandbox with your sandbox API key
  • solvapay-production with your production API key
Both use the same endpoint — the environment is determined by your API key prefix:
Key PrefixEnvironmentData
sk_sandbox_SandboxTest data only
sk_live_ProductionReal data

​
Verifying the Connection

After connecting, ask your AI assistant something simple like:
“List my SolvaPay customers”
If the connection is working, you’ll see a response from the list_customers tool. If your account is new, an empty list is expected.

​
Troubleshooting

“Authentication required” error For config-based clients (Cursor, VS Code): confirm the X-API-Key header is set in your MCP client configuration. For OAuth clients (Claude.ai): try removing and re-adding the connector to re-authenticate. “Invalid or expired secret key” error The API key is being sent but is not valid. Verify it in SolvaPay Console > Settings > API Keys. Make sure you copied the full key. “Invalid or expired provider token” error Your OAuth session has expired. Remove the connector and re-add it — you’ll be prompted to sign in again. Tools not appearing Re-open your AI assistant or reload MCP settings. Some clients require a full restart.