> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # 連線至 MCP Server > 將任何 MCP 用戶端連線到 Ayrshare MCP Server — 涵蓋傳輸方式、端點與身分驗證。 Ayrshare [MCP Server](/additional/mcp-action-server) 讓 AI 代理程式可以驅動 Ayrshare API。本頁說明如何連線以及身分驗證的運作方式。 ## 端點與傳輸方式 正式環境的 MCP Server 位址為： `https://api.ayrshare.com/mcp` 它使用 **Streamable HTTP** 傳輸方式，並且是 **無狀態的（stateless）** —— 呼叫之間不需要維持工作階段。 ## 身分驗證 身分驗證是由為 REST API 提供支援的同一條 Ayrshare API 處理鏈執行。 ### 優先順序：參數優先於標頭 當一次工具呼叫同時包含 `profileKey` 參數 **與** 連線上的 `Profile-Key` 標頭時，**本次呼叫的 `profileKey` 參數優先生效**。只有在未提供有效參數時，才會使用該標頭。 一個例外：在 `get_platform_history` 與 `get_social_network_analytics` 上，X/Twitter 的 `userId` / `userName` 查詢必須僅使用帳戶 API 金鑰;此時若傳入 `profileKey` 參數或 `Profile-Key` 標頭，會回傳 400 錯誤。 MCP 的 `initialize` 與 `tools/list` 方法可以在 **驗證之前** 存取 —— 它們只回傳中繼資料，不會執行任何動作。**所有工具呼叫都必須經過驗證。** ### 驗證錯誤 在工具呼叫中使用未驗證或無效的金鑰，會回傳 Ayrshare **error 403 / code 102**，錯誤訊息為 **"API Key not valid"**。依照 MCP 規範，工具執行錯誤會以內含（in-band）方式回傳：工具結果會帶有 `isError: true` 與該錯誤訊息，而 MCP 傳輸層本身則回傳 **HTTP 200**。（`403` / `102` 是 Ayrshare 的應用層錯誤，而非傳輸層狀態。） ## 連線 ### 方式 A：Claude Code 外掛 如果你使用 Claude Code，可以安裝 Ayrshare 外掛。該外掛已內建 MCP Server 設定、初始化指令、代理程式、技能以及確認 hook。完整安裝步驟請參見 [Claude Code 外掛](/additional/mcp-claude-code-plugin) 頁面。 ### 方式 B：任何 MCP 用戶端 對於任何支援 Streamable HTTP 的 MCP 用戶端，可以直接註冊伺服器。在 Claude Code 中： ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` 若要讓每次呼叫都以某個子設定檔為目標，請加上選用的 `Profile-Key` 標頭： ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "Profile-Key: YOUR_PROFILE_KEY" ``` MCP 連線會在工作階段啟動時初始化。安裝伺服器或變更金鑰後，請 **重新啟動你的 MCP 用戶端**，讓新的設定生效。 ## X/Twitter 自帶（BYO）憑證 自 2026 年 3 月 31 日起，透過 Ayrshare 進行的 X/Twitter 操作需要使用你自己的 OAuth 1.0a 憑證。當工具呼叫的目標是 X/Twitter 時，請在連線上與 `Authorization`（以及選用的 `Profile-Key`）標頭一起附上以下兩個標頭： | 標頭 | 說明 | | ----------------------------- | --------------------------------------------- | | `X-Twitter-OAuth1-Api-Key` | 你的 OAuth 1.0a API Key（Consumer Key） | | `X-Twitter-OAuth1-Api-Secret` | 你的 OAuth 1.0a API Key Secret（Consumer Secret） | 這些標頭與 REST API 所使用的相同 —— 每個 Ayrshare 帳戶對應一組 OAuth 1.0a 金鑰對，並在每個以 X 為目標的請求中傳送（同一組金鑰適用於所有子設定檔）。Ayrshare 在此處不使用 OAuth 2.0。關於設定、政策與疑難排解，請參見 [API 概觀](/apis/overview#xtwitter-byo-credentials) 與 [X BYO Key 設定指南](/dashboard/connect-social-accounts/x-twitter-byo-keys)。 若缺少這些標頭，X/Twitter 工具呼叫會回傳錯誤 `419`（`x_credentials_required`）。 ### 連線時同時設定 BYO 標頭 若要從一開始就設定 X/Twitter BYO 憑證，請在新增伺服器時同時提供兩個 OAuth 1.0a 標頭與 `Authorization` 標頭（若每次呼叫都要以某個子設定檔為目標，也請一併附上 `Profile-Key`）： ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \ --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET" ``` ### 為既有連線補上 BYO 標頭 連線上的標頭在新增伺服器時就已固定，因此若你之前連線時沒有帶上 BYO 標頭，需要先移除伺服器，然後重新新增並提供完整的標頭集合（重新包含你之前已在使用的任何標頭，例如 `Profile-Key`）： ```bash theme={"system"} claude mcp remove ayrshare claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \ --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET" ``` 變更標頭後，請重新啟動 MCP 用戶端讓新設定生效。若你使用的是 Claude Code 外掛而非直接連線，請參見 [Claude Code 外掛 → X/Twitter BYO 憑證](/additional/mcp-claude-code-plugin#xtwitter-byo-credentials)。 ## 後續步驟 按領域分組的 27 個工具，包含適用範圍與用途。 為 Claude Code 安裝 Ayrshare 外掛。