端點與傳輸方式
正式環境的 MCP Server 位址為：https://api.ayrshare.com/mcp
它使用 Streamable HTTP 傳輸方式，並且是 無狀態的（stateless） —— 呼叫之間不需要維持工作階段。
身分驗證
身分驗證是由為 REST API 提供支援的同一條 Ayrshare API 處理鏈執行。- 必填：
Authorization: Bearer YOUR_API_KEY—— 你的帳戶 API 金鑰（涉及設定檔與子設定檔時，需要 Business 方案的金鑰）。 - 選填：
Profile-Key: YOUR_PROFILE_KEY—— 讓此連線上的每一次呼叫都以該子設定檔為目標。 - 每次呼叫可選：
profileKey工具參數 —— 僅讓本次工具呼叫以某個子設定檔為目標。
優先順序：參數優先於標頭
當一次工具呼叫同時包含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 外掛 頁面。方式 B：任何 MCP 用戶端
對於任何支援 Streamable HTTP 的 MCP 用戶端，可以直接註冊伺服器。在 Claude Code 中：Profile-Key 標頭：
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） |
連線時同時設定 BYO 標頭
若要從一開始就設定 X/Twitter BYO 憑證，請在新增伺服器時同時提供兩個 OAuth 1.0a 標頭與Authorization 標頭（若每次呼叫都要以某個子設定檔為目標，也請一併附上 Profile-Key）：
為既有連線補上 BYO 標頭
連線上的標頭在新增伺服器時就已固定，因此若你之前連線時沒有帶上 BYO 標頭，需要先移除伺服器，然後重新新增並提供完整的標頭集合（重新包含你之前已在使用的任何標頭，例如Profile-Key）：
後續步驟
工具目錄
按領域分組的 27 個工具，包含適用範圍與用途。
Claude Code 外掛
為 Claude Code 安裝 Ayrshare 外掛。