模型上下文协议 (MCP)

MCP 服务器通过标准化的接口暴露自定义工具或数据源，以模块化且灵活的方式扩展 Warp 的本地智能体——本质上充当了 Warp 的插件。Warp 支持多种连接协议，包括可流式传输的 HTTPS 和 SSE，以及自定义标头和环境变量。

MCP 是一个开源协议。查看官方 MCP 文档，了解有关此协议工程实现的更多详细信息。

注意

本页面涵盖了 Warp 桌面应用中本地智能体的 MCP 服务器。如果您使用的是云端智能体，请参阅用于云端智能体的 MCP 服务器。

如何访问 MCP 服务器设置

您可以通过以下任意方式导航到 MCP 服务器页面

• 从 设置页面：设置 > 智能体 > MCP 服务器
• 从 Warp Drive：在 个人 > MCP 服务器 下
• 从 命令面板：搜索 Open MCP Servers
• 从 Warp 应用：设置 > 智能体 > Warp Agent > 管理 MCP 服务器

这将显示所有已配置 MCP 服务器的列表，包括当前正在运行的服务器。如果您在 MCP 服务器运行时关闭 Warp，它会在下次启动 Warp 时再次运行。停止的 MCP 服务器在下次启动 Warp 时仍将保持停止状态。

MCP 服务器页面。

添加 MCP 服务器

要添加新的 MCP 服务器，您可以点击 + 添加 按钮。大多数 MCP 客户端的配置可以直接复制粘贴。

您可以添加的 MCP 服务器类型

CLI 服务器 (命令)

提供启动命令。Warp 将在启动时运行此命令，并在退出时关闭它。

添加 CLI MCP 服务器 (命令)。

注意

当您的 MCP 服务器命令或参数包含相对路径时，请务必明确设置 working_directory。这确保了在不同机器和会话中行为的一致性和可预测性。

CLI 服务器 (命令) MCP 配置属性

属性	类型	必需	说明
command	字符串	是	要启动的可执行文件（例如 npx）。
args	字符串数组	是	传递给 command 的命令行参数数组（例如模块名称、路径）。
env	对象	否	环境变量的键值对象（例如 API 令牌）。
working_directory	字符串	否	命令运行的工作目录路径，用于解析相对路径。

可流式传输 HTTP 或 SSE 服务器 (URL)

提供 Warp 可以访问已运行的、支持服务器发送事件 (SSE) 的 MCP 服务器的 URL。

添加 SSE MCP 服务器 (URL)。

可流式传输 HTTP 或 SSE 服务器 (URL) MCP 配置属性

属性	类型	必需	说明
url	字符串	是	通过服务器发送事件 (SSE) 连接的 HTTP 端点 URL。
headers	对象	否	标头变量的键值对象（例如授权）。

添加多个 MCP 服务器

Warp 支持使用 JSON 代码片段配置 多个 MCP 服务器。mcpServers 下的每个条目都由唯一的名称（filesystem、github、notes 等）标识。示例中定义的所有服务器都会自动添加——无需手动设置。

要添加多个 MCP 服务器，您可以点击 + 添加 按钮，然后粘贴如下示例的 JSON 代码片段

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    },
    "notes": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-notes", "--notes-dir", "/Users/you/Documents/notes"]
    },
    "externalDocs": {
      "url": "https://:4000/mcp/stream",
      "headers": {
            "my-header": "my-header-value"
      }
    }
  }
}

基于文件的 MCP 服务器

与在 Warp 设置中手动添加服务器相比，基于文件的服务器定义在 Warp 可以自动检测并启动的配置文件中。它们提供了一些额外的好处

• 可直接通过智能体配置 - 使用内置技能 /agent-add-mcp，这样 Warp 的智能体可以在不离开对话的情况下添加或更新 MCP 服务器。
• 跨提供商和仓库继承 - Warp 会读取 .warp/.mcp.json 文件，并从第三方智能体提供商（Claude Code、Codex 等）中获取配置。相同的服务器定义会跟随您跨工具和仓库。

支持的提供商

Warp 从以下提供商读取 MCP 服务器定义

提供商	全局配置	项目范围配置	自动启动
Warp	~/.warp/.mcp.json	项目根目录下的 .warp/.mcp.json	默认开启
Claude Code	~/.claude.json	项目根目录下的 .mcp.json	需要切换
Codex	~/.codex/config.toml	项目根目录下的 .codex/config.toml	需要切换
其他智能体	~/.agents/.mcp.json	项目根目录下的 .agents/.mcp.json	需要切换

Warp 全局服务器默认自动启动。所有其他提供商的全局服务器仅在启用了 自动启动第三方智能体的服务器 时才会自动启动。任何提供商的项目范围服务器都需要明确批准。

有关特定于提供商的设置，请参阅 Claude Code MCP 文档 和 Codex MCP 文档。

自动启动行为

Warp 全局服务器默认自动启动。第三方智能体服务器要求您先启用自动启动。

要自动启动来自第三方智能体的全局服务器

1. 在 Warp 应用中，转到 设置 > 智能体 > MCP 服务器。
2. 切换 自动启动第三方智能体的服务器 为开启状态。

任何提供商的项目范围服务器必须在 MCP 服务器页面上单独开启。这些是会话范围的——重启 Warp 后，如果您仍然信任该仓库，请再次开启它们。

使用 /agent-add-mcp

内置的 /agent-add-mcp 技能允许 Warp 的智能体创建或更新基于文件的 MCP 服务器定义。选择是全局保存还是保存在当前项目中——该技能会将服务器定义写入匹配的文件

• 全局： ~/.warp/.mcp.json
• 项目范围： {repo_root}/.warp/.mcp.json

该演示展示了如何使用 /agent-add-mcp 添加 MCP 服务器，选择 Warp 保存基于文件配置的位置，并在使用服务器前检查生成的 .warp/.mcp.json 文件。

安全缓解措施

MCP 配置文件可以启动本地命令并将数据发送到外部工具。Warp 在基于文件的 MCP 服务器周围添加了批准门槛，以降低未经信任的配置更改带来的风险

• 配置编辑需要批准 - Warp 阻止对 MCP 配置文件的编辑，除非您明确批准该更改。这可以防止智能体或自动化在未察觉的情况下添加可以运行命令或访问数据的服务器。
• 项目范围服务器从不自动启动 - Warp 检测克隆仓库中的项目范围 MCP 配置文件，但要求您手动启动每个服务器。这可以防止克隆的仓库自动启动运行任意本地命令的 MCP 服务器。

注意

需要 OAuth 的基于文件的服务器在首次启动时会显示身份验证模态。凭据会保存以供将来启动使用，这与手动配置的 MCP 服务器相同。

管理 MCP 服务器

在 Warp 中注册 MCP 服务器后，您可以从 MCP 服务器页面 启动 或 停止 它们。每个运行中的服务器都会有一个可用工具和资源的列表。

您可以重命名和编辑服务器名称，以及删除服务器。如果您属于某个团队，您还可以与您的团队成员共享 MCP。

共享 MCP 服务器

可以通过点击共享图标与您的团队成员共享 MCP 服务器。共享时，env 配置中的敏感值将被自动屏蔽并替换为变量。

共享 MCP 服务器。

您的团队成员可以在其 MCP 设置的 Shared 部分找到共享的 MCP 服务器。当您的团队成员安装您的服务器配置时，系统会提示他们输入任何被屏蔽的 env 值。

Warp 还提供开箱即用的 MCP 服务器，任何人都可以安装。这些可以在您的 MCP 设置的 Shared 部分找到。

MCP 服务器中的身份验证

大多数 MCP 服务器需要身份验证才能连接到外部服务。Warp 支持以下方法

• 环境变量：通过服务器的环境变量传递 API 密钥或访问令牌。
• OAuth 登录（一键安装）：通过浏览器处理身份验证，简化配置。Warp 会将凭据安全地存储在您的设备上，并在以后的会话中重复使用。在新的机器上打开 Warp 时需要重新进行身份验证。
  • 在没有现有凭据的情况下启动服务器会自动打开基于浏览器的身份验证流程。
  • 可以随时从 Warp 中的 MCP 服务器面板撤销凭据。
• 自定义标头：通过标头变量传递身份验证 Bearer 令牌。

调试 MCP

如果您在使用 MCP 服务器时遇到问题，可以通过点击 MCP 服务器页面上服务器的 View Logs 按钮来检查日志，查看是否有任何错误或消息，以帮助您诊断问题。

注意

如果您选择与任何人共享您的 MCP 服务器日志，请确保在共享前删除任何敏感信息，因为它们可能包含 API 密钥。

许多基于 SSE 的 MCP 服务器会声明您的 URL 应被视为密码，并且可以在没有额外身份验证的情况下使用。

注意

提示：我们注意到某些模型在 MCP 服务器上表现得比其他模型更好。如果您在调用或使用 MCP 服务器时遇到问题，请尝试使用不同的模型。

调试 MCP 身份验证问题

在某些情况下，您可能需要重置某些 MCP 服务器的身份验证令牌。为此，请通过运行以下命令删除本地 MCP 身份验证文件： rm -rf ~/.mcp-auth

注意

请注意，这将删除您本地存储的所有 MCP 身份验证令牌，因此您需要登录并重新进行身份验证。

如果上述方法无济于事，并且您需要重置或更改身份验证，您可能需要切换到基于 CLI 的 MCP 服务器配置，并通过环境变量提供令牌。请参阅 Sentry CLI MCP 示例。

MCP 日志存储位置

Warp 会在您的计算机上本地保存 MCP 日志。您可以直接打开文件并在以下位置检查全部内容

macOS

cd "$HOME/Library/Group Containers/2BBY89MBSN.dev.warp/Library/Application Support/dev.warp.Warp-Stable/mcp"

Windows

Set-Location $env:LOCALAPPDATA\warp\Warp\data\logs\mcp

Linux

cd "${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal/mcp"

MCP 服务器配置示例

以下是流行模型上下文协议 (MCP) 服务器的示例。

• CLI 服务器 (命令) — 基于本地 npx 或 docker 命令的 MCP 服务器。
• 可流式传输 HTTP 或 SSE 服务器 (URL) — 远程或本地托管的 MCP 端点。

工程与运营

GitHub

GitHub MCP 文档

GitHub CLI 服务器 (命令)

{
  "GitHub": {
    "command": "docker",
    "args": ["run","-i","--rm","-e","GITHUB_PERSONAL_ACCESS_TOKEN","ghcr.io/github/github-mcp-server"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "<your_github_token>"
    }
  }
}

GitHub SSE 服务器 (URL)

{
  "GitHub": {
    "url": "https://api.githubcopilot.com/mcp/"
  }
}

Sentry

Sentry MCP 文档

Sentry CLI 服务器 (命令)

{
  "Sentry": {
    "command": "npx",
    "args": ["-y","mcp-remote@latest","https://mcp.sentry.dev/mcp"]
  }
}

Sentry SSE 服务器 (URL)

{
  "Sentry": {
    "url": "https://mcp.sentry.dev/sse"
  }
}

Grafana

Grafana MCP 文档

Grafana CLI 服务器 (命令)

{
  "Grafana": {
    "command": "docker",
    "args": ["run","--rm","-i","-e","GRAFANA_URL","-e","GRAFANA_API_KEY","mcp/grafana","-t","stdio","-debug"],
    "env": {
      "GRAFANA_URL": "https://:3000",
      "GRAFANA_API_KEY": "<your_grafana_key>"
    }
  }
}

Grafana SSE 服务器 (URL)

{
  "Grafana": {
    "url": "https://your-mcp-host.com/api/mcp/grafana/sse"
  }
}

Linear

Linear MCP 文档

Linear CLI 服务器 (命令)

{
  "Linear": {
    "command": "npx",
    "args": ["-y","mcp-remote","https://mcp.linear.app/sse"]
  }
}

Linear SSE 服务器 (URL)

{
  "Linear": {
    "url": "https://mcp.linear.app/sse"
  }
}

Chroma

Chroma Package Search CLI 服务器 (命令)

1. 访问 Chroma 的 Package Search 页面。
2. 点击 “Get API Key” 创建或登录您的 Chroma 帐户并为 Package Search 颁发 API 密钥。
3. 颁发 API 密钥后，点击 “Other” 选项卡并复制您的 API 密钥。
4. 将以下内容添加到您的 Warp MCP 配置中。添加后，请确保点击服务器上的 “Start”。

更多信息请参阅 Chroma 的 Package Search MCP 文档

{
    "package-search": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.trychroma.com/package-search/v1", "--header", "x-chroma-token: ${X_CHROMA_TOKEN}"],
      "env": {
        "X_CHROMA_TOKEN": "<YOUR_CHROMA_API_KEY>"
      }
    }
}

设计与协作

Figma

Figma 远程 MCP 服务器 (推荐)

官方 Figma 远程 MCP 服务器支持 OAuth，实现简单的一键式设置。

1. 在 Warp 中，前往 Warp Drive > MCP 服务器 > + 添加 并粘贴以下配置。
2. Warp 将打开一个浏览器窗口以通过 Figma 进行身份验证。
3. 批准访问后，凭据将安全地存储在您的设备上。

注意

注意：需要一个启用了 Dev Mode 的 Figma 帐户。

{
  "Figma": {
    "url": "https://mcp.figma.com/mcp"
  }
}

Figma 本地 MCP 服务器

1. 启用官方 Figma MCP 服务器。Figma MCP 文档
2. 打开 Figma 桌面应用 并确保您已更新到最新版本。
3. 创建或打开一个 Figma 设计文件。
4. 在左上角，打开 Figma 菜单。
5. 在 Preferences 下，选择 Enable local MCP Server。
6. 在 Warp > Warp Drive > MCP 服务器 > + 添加 中输入以下配置。

{
  "Figma (Local)": {
    "url": "http://127.0.0.1:3845/mcp"
  }
}

Slack

Slack MCP 文档

Slack CLI 服务器 (命令)

在 Warp > Warp Drive > MCP 服务器 > + 添加 中输入以下配置。

{
  "Slack": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-slack"],
    "env": {
      "SLACK_BOT_TOKEN": "xoxb-<your-bot-token>",
      "SLACK_APP_TOKEN": "xapp-<your-app-token>",
      "SLACK_TEAM_ID": "T<your_workspace_id>",
      "SLACK_CHANNEL_IDS": "<your_channel_id-1>, <your_channel_id-2>",
      "MCP_MODE": "stdio"
    }
  }
}

Slack SSE 服务器 (URL)

在 Warp > Warp Drive > MCP 服务器 > + 添加 中输入以下配置。

{
  "Slack": {
    "url": "https://your-mcp-host.com/api/mcp/slack/sse"
  }
}

Atlassian

Atlassian MCP 文档

Atlassian CLI 服务器 (命令)

在 Warp > Warp Drive > MCP 服务器 > + 添加 中输入以下配置。

{
  "Atlassian": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.atlassian.com/v1/sse"]
  }
}

Notion

Notion MCP 文档

Notion CLI 服务器 (命令)

在 Warp > Warp Drive > MCP 服务器 > + 添加 中输入以下配置。

{
  "Notion": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
  }
}

Notion SSE 服务器 (URL)

在 Warp > Warp Drive > MCP 服务器 > + 添加 中输入以下配置。

{
  "Notion": {
    "url": "https://mcp.notion.com/sse"
  }
}

MCP 服务器演示

Warp 指南 托管了一系列演示和演练，展示了 MCP 服务器如何扩展您的工作流程。每个示例都突出显示了您今天就可以尝试的实际用例

• GitHub — 通过 MCP 访问存储库、问题和拉取请求。
• Sentry — 将错误监控和警报呈现为智能体可使用的数据。
• Linear — 集成项目管理任务和工单。
• Puppeteer — 通过 MCP 运行自动化的浏览器工作流程。
• Context7 — 试验外部数据集成。