Custom MCP Server
Connect your own MCP server to give your Team Agent access to internal tools, private APIs, or any service not covered by the pre-built catalog. Your server must be accessible over HTTPS and implement the MCP protocol.
Adding a custom server
- Open your agent in the Runbear dashboard and go to the Tools tab.
- Click Add Tool, then select Add Remote MCP Server.
- Fill in the connection details:
| Field | Description |
|---|---|
| Server Name | A friendly name to identify this server (max 100 characters) |
| Server URL | The HTTPS endpoint of your MCP server |
| Transport | Streamable HTTP (default) or SSE (Server-Sent Events) |
| Authentication | How Runbear authenticates with your server (see below) |
- Click Save to connect.
Authentication options
OAuth
Use OAuth when your MCP server supports the OAuth 2.0 authorization flow. After saving, a popup window opens for the user to complete authorization.
OAuth supports two user-type modes:
- User-level (default) — each team member authorizes individually. The agent acts on behalf of the signed-in user.
- App-level — a single authorization covers the entire agent. The agent acts with a shared set of credentials.
Static header
Use a static HTTP header when your server expects an API key or bearer token.
| Field | Description |
|---|---|
| Header Key | The HTTP header name (e.g., Authorization) |
| Header Value | The header value (e.g., Bearer sk-...) |
The header is sent with every request to the server.
None
Choose None if your server does not require authentication (e.g., internal network access or IP-based allowlisting).
Transport types
| Transport | Protocol | Best for |
|---|---|---|
| Streamable HTTP | HTTP POST with streaming responses | Most MCP servers (recommended default) |
| SSE | Server-Sent Events over HTTP | Servers that use long-lived event streams |
Editing or disconnecting
To update server details, open the Tools tab, click the server tile, and modify the fields. When editing, you can leave the header value empty to keep the current value.
To disconnect, click the more options menu on the server tile and select Disconnect.