Adding an MCP server
Click Add MCP Server and configure both the staging and production stages:| Field | Description |
|---|---|
| Name | Display name used when selecting MCP servers in agent creation |
| Description | What tools this server provides. Helps you identify it later. |
| Staging URL | Endpoint for the test/development MCP server |
| Production URL | Endpoint for the live MCP server |
| Transport | Protocol for communicating with the server |
| Credentials | Auth credentials if the server requires them (stored as secrets) |
Transport types
| Transport | Description | Use when |
|---|---|---|
sse | Server-Sent Events over HTTP | Remote MCP servers (most common) |
http | Plain HTTP requests | Simple REST-style MCP servers |
stdio | Standard input/output | Local process-based MCP servers |
Staging vs Production stages
Each MCP server has two stages with independent URLs and credentials:- Staging — used during agent development and testing
- Production — used when the agent goes live
Agents always use whichever stage is currently marked active on the MCP server. You don’t need to update agents when you switch a server from staging to production.
Health check
Studio periodically checks the server’s availability. A green indicator means the server is reachable. A red indicator means the server is down or unreachable — agents using this server may fail to call its tools.Credentials
If the MCP server requires authentication (API key, bearer token, etc.), enter the credentials when configuring the server. They’re stored as secrets and injected at runtime via the$secretRef pattern.
Using MCP servers in agents
Once registered here, MCP servers appear under MCP Tools during agent creation. See MCP Tools for how to assign them to agents.Next steps
MCP Tools in Agent Creation
Add registered MCP servers to an agent.