Endpoint và transport
MCP Server phiên bản production có sẵn tại:https://api.ayrshare.com/mcp
Nó sử dụng transport Streamable HTTP và là stateless — không có phiên nào cần duy trì giữa các lệnh gọi.
Xác thực
Xác thực được thực thi bởi cùng chuỗi API Ayrshare cung cấp năng lượng cho REST API.- Bắt buộc:
Authorization: Bearer YOUR_API_KEY— API key tài khoản của bạn (khóa Business plan cho profiles và sub-profiles). - Tùy chọn:
Profile-Key: YOUR_PROFILE_KEY— nhắm tới một sub-profile cho mọi lệnh gọi trên kết nối. - Tùy chọn theo mỗi lệnh gọi: một đối số công cụ
profileKey— nhắm tới một sub-profile cho một lệnh gọi công cụ duy nhất.
Thứ tự ưu tiên: đối số thắng header
Khi một lệnh gọi công cụ bao gồm đối sốprofileKey và kết nối có header Profile-Key, đối số profileKey theo lệnh gọi thắng. Header chỉ được sử dụng khi không có đối số hợp lệ nào được cung cấp.
Một ngoại lệ: trên get_platform_history và get_social_network_analytics, việc tra cứu userId/userName của X/Twitter phải sử dụng chỉ API key tài khoản; việc cung cấp đối số profileKey hoặc header Profile-Key ở đó sẽ trả về Lỗi 400.
Các phương thức MCP
initialize và tools/list có thể truy cập được trước khi xác thực — chúng chỉ trả về metadata và không thực thi gì. Mọi lệnh gọi công cụ đều được xác thực.Lỗi xác thực
Một khóa không được xác thực hoặc không hợp lệ trên một lệnh gọi công cụ sẽ trả về error 403 / code 102 của Ayrshare với thông báo “API Key not valid”. Theo đặc tả MCP, lỗi thực thi công cụ được trả về in-band: kết quả công cụ mangisError: true và thông báo này, trong khi bản thân transport MCP phản hồi HTTP 200. (Mã 403/102 là lỗi ứng dụng của Ayrshare, không phải trạng thái transport.)
Kết nối
Tùy chọn A: Plugin Claude Code
Nếu bạn dùng Claude Code, hãy cài đặt plugin Ayrshare. Nó đóng gói cấu hình MCP Server, một lệnh thiết lập, các agent, các skill và một hook xác nhận. Xem trang Claude Code Plugin để biết đầy đủ các bước cài đặt.Tùy chọn B: Bất kỳ client MCP nào
Đối với bất kỳ client MCP nào hỗ trợ Streamable HTTP, hãy đăng ký server trực tiếp. Trong Claude Code:Profile-Key tùy chọn:
Thông tin xác thực BYO cho X/Twitter
Kể từ ngày 31 tháng 3 năm 2026, các thao tác X/Twitter qua Ayrshare yêu cầu thông tin xác thực OAuth 1.0a của riêng bạn. Khi một lệnh gọi công cụ nhắm tới X/Twitter, hãy chuyển tiếp hai header này trên kết nối cùng với các headerAuthorization (và Profile-Key tùy chọn) của bạn:
| Header | Mô tả |
|---|---|
X-Twitter-OAuth1-Api-Key | OAuth 1.0a API Key (Consumer Key) của bạn |
X-Twitter-OAuth1-Api-Secret | OAuth 1.0a API Key Secret (Consumer Secret) của bạn |
Kết nối với các header BYO
Để thiết lập thông tin xác thực BYO cho X/Twitter ngay từ đầu, hãy thêm server với cả hai header OAuth 1.0a cùng với headerAuthorization của bạn (cũng bao gồm Profile-Key nếu bạn nhắm tới một sub-profile trên mọi lệnh gọi):
Thêm các header BYO vào kết nối hiện có
Các header kết nối là cố định khi server được thêm vào, vì vậy nếu bạn đã kết nối mà không có các header BYO, hãy xóa server và thêm lại nó với đầy đủ tập hợp (bao gồm lại bất kỳ header nào bạn đã sử dụng trước đó, chẳng hạn nhưProfile-Key):
Các bước tiếp theo
Danh mục Công cụ
27 công cụ được nhóm theo miền, với phạm vi và mục đích.
Plugin Claude Code
Cài đặt plugin Ayrshare cho Claude Code.