Add an MCP server

The agent can interact with external tools using the Model Context Protocol (MCP). This feature provides a standardized way for the agent to use tools and extend knowledge and capabilities with the external environment.

There are many tools you can connect to the MCP Host in Android Studio. For example, you can integrate with the GitHub MCP Server to create pull requests directly from Android Studio or with the Figma remote MCP server to provide design information without downloading the desktop app. For more ideas, see the MCP example servers.

To add an MCP server, go to the MCP server settings by clicking File (Android Studio on macOS) > Settings > Tools > AI > MCP Servers. You can add MCP servers using the marketplace, or click Add via JSON to add the MCP configuration to the mcp.json file in the configuration directory of Android Studio.

The following example shows an mcp.json file with several server configurations:

{
  "mcpServers": {
    "figma": {
      "httpUrl": "https://mcp.figma.com/mcp"
    },
    "github": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer <YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    },
    "gitlab": {
      "httpUrl": "https://gitlab.com/api/v4/mcp"
    },
    "canva": {
      "httpUrl": "https://mcp.canva.com/mcp"
    },
    "notion": {
      "httpUrl": "https://mcp.notion.com/mcp"
    },
    "linear": {
      "httpUrl": "https://mcp.linear.app/mcp"
    }
  }
}

For the precise configuration values to list in this file, see the documentation for the MCP server that you're integrating with.

Authentication

After clicking OK, you will either see a notification saying "Successfully connected to MCP server..." or a notification describing an error. Most remote MCP Servers require authentication and therefore return "Error connecting to transport: Authorization Exception" when authorization fails.

Click Start Login to initiate the authentication process for that server. You will be asked to sign in to that server's login page in your browser. After you log in, the connection is attempted again and, if successful, you will see the "Successfully connected to MCP server..." notification.

Use MCP tools

To see which tools are available to the agent, type /mcp in the chat.

You can then reference the tools in the chat, for example, "list my repositories on GitHub".

Configurations

This section describes all the MCP server configuration options.

HTTP MCP server

The following table lists the configuration options for connecting to an MCP server through a streamable HTTP transport.

Name	Type	Description
`httpUrl`	String	Required. The full URL of the streamable HTTP endpoint (for example, `https://example.com/mcp` or `http://localhost:1234/mcp`).
`headers`	Map<String, String>	A map of custom HTTP headers to include in the connection request. Defaults to `{}` (an empty map).
`timeout`	Long	Connection timeout in milliseconds. -1 indicates no timeout. Defaults to -1.
`enabled`	Boolean	Whether this server configuration is active. Defaults to `true`.

Limitations

Android Studio's MCP integration doesn't support the following features:

Connection to MCP servers through stdio transport
MCP resources
Prompt templates
OAuth login with some MCP servers, such as GitHub