​
什麼是 MCP？

Model Context Protocol (MCP) 讓 Cursor 能夠連接到外部工具和資料來源。

​
為什麼使用 MCP？

MCP 將 Cursor 連接到外部系統和資料。無需重複解釋您的專案結構，直接與您的工具整合。 使用任何能夠輸出到 stdout 或提供 HTTP 端點的語言編寫 MCP 伺服器 - Python、JavaScript、Go 等。

​
運作原理

MCP 伺服器透過協定公開功能，將 Cursor 連接到外部工具或資料來源。 Cursor 支援三種傳輸方法：
傳輸方式執行環境部署使用者輸入驗證
stdio本地Cursor 管理單一使用者Shell 命令手動
SSE本地/遠端部署為伺服器多個使用者SSE 端點的 URLOAuth
Streamable HTTP本地/遠端部署為伺服器多個使用者HTTP 端點的 URLOAuth

​
安裝 MCP 伺服器

​
一鍵安裝

從我們的集合中安裝 MCP 伺服器並使用 OAuth 進行身份驗證。

瀏覽 MCP 工具

瀏覽可用的 MCP 伺服器

新增至 Cursor 按鈕

建立「新增至 Cursor」按鈕

​
使用 mcp.json

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

​
配置位置

專案配置

在您的專案中建立 .cursor/mcp.json 以使用專案特定的工具。

全域配置

在您的主目錄中建立 ~/.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 實際應用的範例，請參閱我們的網頁開發指南，該指南示範如何將 Linear、Figma 和瀏覽器工具整合到您的開發工作流程中。

​
常見問題