SynapseDocumentation
MCP

ChatGPT Custom MCP App

Register Synapse Remote MCP as a ChatGPT custom MCP app with OAuth.

ChatGPT custom MCP apps should use Synapse OAuth.

Requirements

  • ChatGPT Business, Enterprise, Edu, or another plan with custom MCP app support.
  • Developer mode enabled for the user or workspace.
  • A Synapse wallet session with a supported Arbitrum wallet such as MetaMask or Rabby.
  • A dedicated Agent Credential for ChatGPT, preferably with conservative spend and call limits.

App settings

FieldValue
MCP endpointhttps://mcp.synapse-network.ai/mcp
AuthOAuth
Authorization serverhttps://www.synapse-network.ai
Read scopessynapse.discovery.read synapse.receipts.read offline_access
Write scopesynapse.invocations.write

Registration flow

  1. In ChatGPT, open Workspace Settings.
  2. Go to Apps and create a custom app.
  3. Enter the MCP endpoint.
  4. Choose OAuth.
  5. Complete the Synapse authorization prompt.
  6. Click Scan Tools.
  7. Confirm that ChatGPT imports discover_services, get_receipt, and invoke_and_pay.
  8. Before publishing, configure action controls.

Action controls

ToolRecommended control
discover_servicesAllow without confirmation
get_receiptAllow without confirmation
invoke_and_payRequire confirmation

Troubleshooting

  • Wallet connection is unavailable: install or enable MetaMask or Rabby and retry.
  • Tool scan fails with 401: complete OAuth authorization again.
  • Tool scan fails with 424: check OAuth scopes and make sure the connector passes a valid access token.
  • Tools changed after publishing: refresh or recreate the custom app so ChatGPT re-scans tool definitions.

On this page