​
什麼是 MCP？

Model Context Protocol（MCP） 讓 Cursor 能連接外部工具與資料來源。

​
為什麼要用 MCP？

MCP 讓 Cursor 能連到外部系統與資料。與其反覆解釋你的專案結構，不如直接和你的工具整合。 用任何能輸出到 stdout 或提供 HTTP 端點的語言撰寫 MCP 伺服器——Python、JavaScript、Go 等等。

​
運作方式

MCP 伺服器透過協定公開能力，將 Cursor 連接到外部工具或資料來源。 Cursor 支援三種傳輸方式：
TransportExecution environmentDeploymentUsersInputAuth
stdioLocalCursor managesSingle userShell commandManual
SSELocal/RemoteDeploy as serverMultiple usersURL to an SSE endpointOAuth
Streamable HTTPLocal/RemoteDeploy as serverMultiple usersURL to an HTTP endpointOAuth

​
協定支援

Cursor 支援以下 MCP 協定能力：
FeatureSupportDescription
ToolsSupportedFunctions for the AI model to execute
PromptsSupportedTemplated messages and workflows for users
RootsSupportedServer-initiated inquiries into uri or filesystem boundaries to operate in
ElicitationSupportedServer-initiated requests for additional information from users

​
安裝 MCP 伺服器

​
一鍵安裝

從我們的精選集中安裝 MCP 伺服器，並透過 OAuth 完成驗證。

Browse MCP Tools

瀏覽可用的 MCP 伺服器

Add to Cursor Button

建立「Add to Cursor」按鈕

​
使用 mcp.json

用 JSON 檔設定自訂 MCP 伺服器： 
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

​
使用 Extension API

若要以程式方式註冊 MCP 伺服器，Cursor 提供 extension API，可在不修改 mcp.json 的情況下動態設定。這對企業環境與自動化建置流程特別實用。

MCP Extension API Reference

了解如何使用 vscode.cursor.mcp.registerServer() 以程式方式註冊 MCP 伺服器

​
設定位置

Project Configuration

在你的專案中建立 .cursor/mcp.json，提供專案專屬工具。

Global Configuration

在使用者主目錄建立 ~/.cursor/mcp.json，讓工具在各處可用。

​
驗證

MCP 伺服器使用環境變數進行驗證。請透過設定檔傳遞 API 金鑰與權杖。 對需要的伺服器，Cursor 也支援 OAuth。

​
在聊天中使用 MCP

Composer Agent 會在需要時自動使用列在 Available Tools 下的 MCP 工具。可以直接用名稱指定工具，或描述你要做的事。也可以在設定中啟用或停用工具。

​
切換工具

你可以直接在聊天介面啟用或停用 MCP 工具。點一下工具清單中的工具名稱即可切換。被停用的工具不會載入到上下文中，Agent 也無法使用。

​
工具核准

預設 Agent 在使用 MCP 工具前會先請求核准。點擊工具名稱旁的箭頭即可查看參數。

​
自動執行

啟用自動執行後，Agent 使用 MCP 工具時不會再詢問。行為類似終端機指令。關於 Yolo 模式的更多資訊請見這裡。

​
工具回應

Cursor 會在聊天中顯示回應，並提供可展開檢視的參數與回應內容：

​
影像作為上下文

MCP 伺服器可以回傳影像——截圖、圖表等。請以 base64 編碼字串回傳： 
const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ 為了可讀性已截短完整的 base64

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});
實作細節請參考這個範例伺服器。Cursor 會把回傳的影像附加到聊天中。如果模型支援影像，會加以分析。

​
安全性考量

安裝 MCP 伺服器時，請留意以下安全作法：
  • 驗證來源：只從可信賴的開發者與套件庫安裝 MCP 伺服器
  • 檢視權限：確認伺服器會存取哪些資料與 API
  • 限制 API 金鑰：使用權限最小化、受限的 API 金鑰
  • 稽核程式碼：對關鍵整合，檢閱伺服器的原始碼
請記得，MCP 伺服器可以代你存取外部服務並執行程式碼。安裝前一定要先搞清楚伺服器會做什麼。

​
真實世界範例

想看 MCP 的實際應用範例，去看我們的 Web Development 指南，裡面示範如何把 Linear、Figma 與瀏覽器工具整合進你的開發流程。

​
常見問題