Warp documentation
  • Getting Started
    • Quickstart Guide
    • What is Warp?
    • Supported Shells
    • Migrate to Warp
    • Keyboard Shortcuts
    • Changelog
  • Agents
    • Warp AI
    • Using Agents
      • Agent Conversations
      • Agent Context
      • Model Choice
    • Autonomy
      • Agent Permissions
      • Run to completion
    • Code
      • Codebase Context
      • Reviewing Agent Code
    • Active AI
    • Generate
    • Voice
    • AI FAQs
  • Terminal
    • Appearance
      • Themes
      • Custom Themes
      • Prompt
      • Input Position
      • Text, Fonts, & Cursor
      • Size, Opacity, & Blurring
      • Pane Dimming & Focus
      • Blocks Behavior
      • Tabs Behavior
      • App Icons
    • Blocks
      • Block Basics
      • Block Actions
      • Block Sharing
      • Block Find
      • Block Filtering
      • Background Blocks
      • Sticky Command Header
    • Modern Text Editing
      • Alias Expansion
      • Command Inspector
      • Syntax & Error Highlighting
      • Vim Keybindings
    • Command Entry
      • Command Corrections
      • Command Search
      • Command History
      • Synchronized Inputs
      • YAML Workflows
    • Command Completions
      • Completions
      • Autosuggestions
    • Command Palette
    • Session Management
      • Launch Configurations
      • Session Navigation
      • Session Restoration
    • Window Management
      • Global Hotkey
      • Tabs
      • Split Panes
    • Warpify
      • Subshells
      • SSH
      • SSH Legacy
    • More Features
      • Accessibility
      • Files, Links, & Scripts
      • Markdown Viewer
      • Working Directory
      • Smart-Select
      • Full-screen Apps
      • Notifications & Audible Bell
      • Settings Sync (Beta)
      • Quit Warning
      • URI Scheme
      • Linux
    • Comparisons
      • Performance
      • Terminal features
    • Integrations
  • Knowledge & Collaboration
    • Warp Drive
      • Notebooks
      • Workflows
      • Prompts
      • Environment Variables
      • Warp Drive on the Web
      • Warp Drive as Agent Mode Context
    • Model Context Protocol
    • Rules
    • Teams
    • Session Sharing
  • Privacy
    • Privacy
    • Secret Redaction
    • Network Log
  • Community
    • Refer a Friend & Earn Rewards
    • Warp Preview & Alpha Program
  • Support & Billing
    • Sending Feedback & Logs
    • Plans & Pricing
    • Updating Warp
    • Using Warp Offline
    • Logging out & Uninstalling
    • Known Issues
    • Troubleshooting Login Issues
    • Open Source Licenses
Powered by GitBook
On this page
  • Model Context Protocol (MCP)
  • How to access MCP Server settings
  • Adding an MCP Server
  • Managing MCP servers
  • Debugging

Was this helpful?

  1. Knowledge & Collaboration

Model Context Protocol

How to use Model Context Protocol (MCP) servers in Warp

PreviousWarp Drive as Agent Mode ContextNextRules

Last updated 14 days ago

Was this helpful?

Model Context Protocol (MCP)

Model Context Protocol (MCP) servers expose data sources or tools to Warp's Agent Mode through a standardized interface — essentially acting like plugins for Warp. This allows you to extend the Agent's capabilities in a modular, flexible way.

MCP is an open source protocol. Check out the official MCP documentation for more detailed information on how this protocol is engineered.

In these docs, we'll focus on how to use MCP servers in Warp.

How to access MCP Server settings

You can navigate to the MCP servers page in any of the following ways:

  • From Warp Drive, under Personal > MCP Servers.

  • From the Command Palette, search for Open MCP Servers.

  • From Settings > AI > Manage MCP servers.

Now, you should see a list of all the MCP servers you have added in Warp, including which servers are currently running.

Adding an MCP Server

To add a new MCP server, you can click the + Add button. There are two types of MCP servers you can add:

  • CLI Server (Command)

    • If you provide a startup command, Warp will execute this command on start and handle stopping the server when Warp shuts down.

  • SSE (URL)

    • Warp will expect a valid MCP server to be listening at the provided URL.

Managing MCP servers

After MCP servers are registered in Warp, you can Start or Stop them from the MCP servers page. Each running server will have a list of available tools and resources.

You can rename and edit a server's name, as well as delete the server. To prevent Warp from automatically starting a server when you open Warp, set the "start_on_launch" value to false in the server's JSON configuration.

Debugging

If you're having trouble with an MCP server, you can check the logs for any errors or messages to help you diagnose the problem by clicking the View Logs button on a server from the MCP servers page.

If you choose to share your MCP server logs with anybody, make sure to remove any sensitive information before sharing, as they may contain API keys. Many SSE based MCP servers will state that your URL should be treated like a password, and can be used with no additional authentication.

Tip: We've noticed that some models often work better with MCP servers than others. If you're having trouble calling or using an MCP server, try using a different model.

MCP logs

Warp saves the MCP logs locally on your computer. You can open the files directly and inspect the full contents in the following location:

cd "$HOME/Library/Application Support/dev.warp.Warp-Stable/mcp"
Set-Location $env:LOCALAPPDATA\warp\Warp\data\logs\mcp
cd "${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal/mcp"
MCP servers page
Adding a CLI MCP Server (Command)
Adding an SSE MCP Server (URL)