Skip to main content

Configure MCP Servers

Model Context Protocol (MCP) servers make external tools and resources available to agents. A server can run as a local process or connect through a remote URL.

Add a server​

Open Settings → Agents → MCP Servers. Add a server directly or install an MCP item from Marketplace.

Before enabling it, review:

  • the local command or remote URL;
  • required environment values and authentication;
  • whether it belongs to project or global scope;
  • the systems and data its tools can access.

Project scope is appropriate for a repository integration shared with the team. Global scope is appropriate for a personal connection used across projects.

Read the connection state​

The MCP Servers tab reports whether a server is connected, disabled, failed, or waiting for authentication or client registration. Resolve the displayed state before depending on its tools in a session.

Use MCP safely​

Agent permissions control whether an MCP tool may be called, but the external service can have its own account and authorization scope. Confirm which organization, environment, and data the connection can reach.

Keep secrets in the supported environment or authentication mechanism. Do not place them in prompts or committed configuration.

Continue with Use MCP in a Session or review MCP server transports.