Skip to main content
You can connect to MCP servers over STDIO or Streamable HTTP, with OAuth 2 and Dynamic Client Registration (DCR) support. Multiple servers can be connected at once within a workspace.

​
Manage connections

You can connect to multiple MCP servers simultaneously. To manage connections, go to the Servers tab in the MCPJam sidebar.
Multiple
  • Toggle MCP servers to enable or temporarily deactivate a server.
  • Hit the 3 dots. You can reconnect, edit, or disconnect to a server.
  • Click “View server info” to open a detailed modal showing server metadata, protocol version, capabilities, and instructions.

​
Server info modal

View comprehensive server details in a dedicated modal dialog:
  • Server metadata: Name, title, version, protocol version, and transport type
  • Capabilities: Tools, prompts, and resources supported by the server
  • Instructions: Server-provided instructions for AI assistants
  • Raw capabilities: Full JSON of server and client capabilities (with copy button)
  • OpenAI Apps SDK: For servers using the OpenAI Apps SDK, view widget metadata in a separate tab

​
Server information

Each connected server card displays:
  • Server icon and version: If provided by the server, the icon and version number appear in the card header
  • Connection status: Real-time indicator showing connected, connecting, or failed status with retry count
  • Transport type: Shows whether the server uses STDIO or Streamable HTTP
Click “Show details” to expand additional server information:
  • Server capabilities: Lists available features (Tools, Prompts, Resources)
  • MCP protocol version: The protocol version the server implements
  • Instructions: Server-provided instructions for AI assistants
  • Documentation link: Direct link to the server’s documentation if available

​
OpenAI app metadata

Servers that provide OpenAI-compatible tool metadata display an OpenAI logo indicator. Expanding these servers shows two tabs:
  • Info tab: Standard server information and capabilities
  • OpenAI Tool Metadata tab: Detailed metadata for each tool including read/write permissions and widget configuration
Using the hosted app? Only HTTPS connections are available. STDIO and plain HTTP connections require the local inspector. See Hosted App for details.

​
STDIO servers

Connect to STDIO with commands. Commands vary based on what language your MCP server is built with. For example, connecting to an MCP server built with Node might look like: 
node /path/to/your/server.js
For local development, always use absolute paths (e.g., /Users/yourname/project/server.py) to avoid path resolution issues.
STDIO

​
Environment variables

You can configure environment variables with STDIO. Click “Add Variable” in the Environment Variables section. This is often used to pass dynamic values like API tokens to a STDIO server.

​
HTTP servers

Connect to any Streamable HTTP MCP server by selecting HTTP in the transport dropdown and pasting in the URL — typically ending in /mcp.
Streamable HTTP

​
Custom headers

Expand Custom Headers to add arbitrary request headers (for example, proxy auth or tenant identifiers). Headers are sent on every request to the server.

​
Authentication

MCPJam is compliant with the MCP authorization spec and supports Dynamic Client Registration (DCR), client pre-registration, and Client ID Metadata Documents (CIMD). You can:
  1. Choose No Authentication
  2. Choose Bearer Token — use this if you already have an API token and don’t need to register an OAuth client.
  3. Choose OAuth — follow MCP Authorization to obtain a bearer token. You can optionally set scopes or a custom client ID and secret. For step-by-step debugging, see the OAuth Debugger.

​
Request timeout

Expand Additional Configuration to override the request timeout (default 10000 ms). Increase this when talking to slow or cold-start servers.

​
Tunneling

Expose your local MCP servers over HTTPS for remote access. This lets you share your servers with external clients and applications without deploying them.

​
Create a tunnel

  1. Go to the MCP Servers tab
  2. Click Create Tunnel in the header
  3. The tunnel URL is automatically copied to your clipboard
Once created, each connected server gets its own tunnel URL. Click Copy Tunnel Url on any server card to copy its specific endpoint.

​
Close a tunnel

Click Close Tunnel in the header to stop remote access. The tunnel closes immediately and all remote connections are terminated.
Tunnel URLs are publicly accessible without authentication. Only create tunnels when you need remote access, and close them when done.