Sui Logo

Claude Desktop Configuration

Configure Claude Desktop to use the MCP server for Sui a402 payments.

Config File Locations

macOS

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

Windows

%APPDATA%\\Claude\\claude_desktop_config.json

Linux

~/.config/Claude/claude_desktop_config.json

Configuration

Add the following configuration to your Claude Desktop config file. Important: Use absolute paths!

{
  "mcpServers": {
    "beep-payments": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-server/dist/mcp-server.js"
      ],
      "env": {
        "BEEP_API_KEY": "beep_sk_your_actual_key",
        "BEEP_SERVER_URL": "https://api.justbeep.it",
        "COMMUNICATION_MODE": "stdio",
        "NODE_ENV": "production",
        "SUI_PRIVATE_KEY": "suiprivkey1qpq...er0gw7f0vj07yzcyswx0"
      }
    }
  }
}

Note: SUI_PRIVATE_KEY is optional. Only needed if you want Claude to autonomously make payments using the payWithWallet tool.

⚠️ Important: Replace /absolute/path/to/mcp-server/ with your actual project path. Do not use ~/ or relative paths.

Path Examples

macOS/Linux Example:

/Users/yourusername/Desktop/mcp-server/dist/mcp-server.js

Windows Example:

C:\\Users\\yourusername\\Desktop\\mcp-server\\dist\\mcp-server.js

After Configuration

  1. Save the config file
  2. Completely quit Claude Desktop (not just close the window)
  3. Reopen Claude Desktop
  4. Start a new conversation
  5. Test with: "Can you check if the Beep API is available?"

Troubleshooting

Server not appearing

  • Verify the path is absolute (no ~ or relative paths)
  • Check that dist/mcp-server.js exists
  • Restart Claude Desktop completely
  • Check logs: ~/Library/Logs/Claude/ (macOS)

API key errors

  • Verify API key format: starts with beep_sk_
  • Check .env file exists in the MCP server directory
  • Rebuild after .env changes: npm run build

Private key issues (payWithWallet)

  • Verify format: bech32 (suiprivkey...), hex (0x...), or base64
  • Ensure SUI_PRIVATE_KEY is set in .env or Claude config
  • Wallet must have sufficient USDC balance for payments
  • Private key is only needed for autonomous payments, not for payment requests