Model Context Protocol (MCP) extends Kiro's capabilities by connecting to specialized servers that provide additional tools and context. This guide helps you set up, configure, and use MCP servers with Kiro across all surfaces.
| Capability | IDE | CLI | Web | Mobile |
|---|---|---|---|---|
| Local (stdio) MCP servers | ✓ | ✓ | ✓ | ✓ |
| Remote (HTTP/SSE) MCP servers | ✓ | ✓ | ✓ | ✓ |
| OAuth sign-in for remote MCP servers | ✓ | ✓ | Powers only | Powers only |
| MCP config file (JSON) | ✓ | ✓ | ✓ | ✓ |
| Server-provided prompts and resources | ✓ | ✓ | ✓ | — |
In Kiro Web and in sessions you start from Kiro Mobile, remote MCP servers connect with a URL and optional headers, such as an Authorization header that uses a secret. The oauth settings in mcp.json aren't used. To connect a service that needs an OAuth sign-in, install its Power and select Authorize. Kiro Mobile has no # mention menu, so it can't insert server-provided prompts or resources.
MCP is a protocol that allows Kiro to communicate with external servers to access specialized tools, prompts, and resources. For example, the AWS Documentation MCP server provides tools to search, read, and get recommendations from AWS documentation directly within Kiro.
With MCP, you can:
- Access specialized knowledge bases and documentation
- Integrate with external services and APIs
- Extend Kiro's capabilities with domain-specific tools
- Use server-provided prompt templates and resource templates via the
#mention system in chat - Respond to server elicitation requests when tools need additional input during execution
- Create custom tools for your specific workflows
Before using MCP, make sure you have:
- The latest version of Kiro installed
- Any specific prerequisites for the MCP servers you want to use (listed in each server's documentation)
Open the MCP configuration
Open the command palette (Cmd + Shift + P on Mac, Ctrl + Shift + P on Windows/Linux) and search for Kiro: Open workspace MCP config (JSON) or Kiro: Open user MCP config (JSON).
Alternatively, open the Kiro panel and select the Open MCP Config icon.
Add your server configuration
{ "mcpServers": { "fetch": { "command": "uvx", "args": ["mcp-server-fetch"], "disabled": false } } }
Save and verify
Save the config file (Cmd+S). Servers reconnect automatically. Check the MCP servers tab in the Kiro panel to confirm the server is connected.
Some server directories and websites offer one-click install links that use the kiro:// URL scheme. Opening one of these links doesn't change your setup immediately: Kiro shows a confirmation dialog before anything is written to your configuration. The dialog lists the command that will run and its arguments, along with the names of any environment variables or headers - their values stay hidden. Review the details and confirm to add the server, or cancel to leave your configuration unchanged.
You can also define MCP servers directly in an agent's configuration file. The mcpServers field specifies which MCP servers the agent has access to:
{ "name": "myagent", "description": "My special agent", "mcpServers": { "fetch": { "command": "fetch3.1", "args": [] } }, "includeMcpJson": false }
The includeMcpJson field determines whether to include MCP servers defined in workspace and user-level configuration files. When set to true, the agent has access to all MCP servers defined in user and workspace-level configurations in addition to those defined in the agent's mcpServers field.
- Open the Kiro panel
- Select the Output tab
- Choose "Kiro - MCP Logs" from the dropdown
| Issue | Solution |
|---|---|
| Connection failures | Verify prerequisites are installed correctly |
| Permission errors | Check that tokens and API keys are valid |
| Tool not responding | Review MCP logs for specific error messages |
| Configuration not loading | Validate JSON syntax and save the config file |
If you see "The following tools have been excluded due to validation errors", the tool fails one of these requirements:
- Tool name exceeds 64 characters (including server prefix)
- Tool name contains invalid characters (must match
^[a-zA-Z][a-zA-Z0-9_]*$) - Tool description is empty
Contact the MCP server maintainer to fix the tool specification.
If you see "The following tools have large descriptions which may impact agent performance", a tool description exceeds 10,000 characters. The tool still works but may slow down responses. Consider asking the server maintainer to shorten the description.
- Configuration - Detailed configuration options and file structure
- MCP server directory - Browse curated MCP servers and add them to Kiro
- Share MCP servers - Create install links and an Add to Kiro badge for your server
- Tools - Learn how to use MCP tools effectively
- Best practices - Security best practices for MCP usage
Model Context Protocol (MCP)