Skip to content

Connecting ChatGPT

ChatGPT connects to Bridge Town’s public Streamable HTTP MCP endpoint through OAuth. No Bridge Town API token is needed. ChatGPT processes the conversation under your agreement with OpenAI; Bridge Town receives only the MCP tool calls and arguments ChatGPT sends.

Prerequisites

Section titled “Prerequisites”
  • A ChatGPT account whose account and workspace policy allow Plugins and Developer mode
  • A Bridge Town account

Connect

Section titled “Connect”

  1. In ChatGPT, open Settings → Security and login and turn on Developer mode if your workspace permits it.

  2. Open ChatGPT Plugins.

  3. Select + and enter Bridge Town as the user-facing name.

  4. Choose the public endpoint connection and paste the complete MCP URL:

    https://api.bridgetown.builders/mcp

  5. Create the connection and sign in to Bridge Town when OAuth opens.

  6. Review the complete permission screen and approve only if it matches the capabilities below.

  7. Confirm ChatGPT discovers the Bridge Town tools and metadata.

These steps follow the official OpenAI plugin connection guide. Availability can depend on account and workspace policy; Bridge Town does not describe a policy-blocked setup as a working partial connection.

Review the initial permissions

Section titled “Review the initial permissions”

ChatGPT and Claude.ai receive the same initial request for all nine approved capabilities:

  • models:read and models:write — read, create, change, merge, and delete model content
  • runs:execute — execute model code in Bridge Town isolated compute
  • history:read — read versions, run results, audit history, and commentary
  • data:read and data:write — read and manage uploads, data sources, and snapshots
  • sheets:read and sheets:write — read and change native sheets and separately authorized Google Sheets
  • sharing:manage — change model, collaborator, and dashboard sharing

See the plain-language scope reference for external and destructive effects. Declining stops the connection. If ChatGPT workspace policy removes a capability, Bridge Town blocks affected tools before any effect and returns the missing scope to request from the workspace administrator.

Verify

Section titled “Verify”

Start a new conversation, add Bridge Town from the tools menu, and ask:

“List the Bridge Town models I can access.”

ChatGPT should call the model-listing tool and return only workspaces allowed by your Bridge Town membership and role. OAuth scopes never bypass those checks.

Troubleshooting

Section titled “Troubleshooting”

Developer mode or Plugins is unavailable

  • Ask the ChatGPT workspace administrator whether Plugins and Developer mode are allowed.
  • Do not substitute a reduced tool or permission set and treat it as the complete Bridge Town connection.

Authorization is declined

  • No Bridge Town MCP connection is created. Start the connection again only when you are ready to review and approve the full permission set.

A tool reports insufficient-scope

  • Note the returned missing_scopes value.
  • Ask the ChatGPT workspace administrator to allow that capability.
  • Reconnect, review the complete consent screen, and retry the tool.

ChatGPT cannot discover the server

  • Confirm the URL is public HTTPS and ends in /mcp.
  • Remove any URL for mcp.bridgetown.builders; it is not the connection endpoint.
  • Refresh the connection metadata after Bridge Town deploys an authorization or tool-metadata change.