Skip to main content
MCP Server của Ayrshare cho phép một AI agent điều khiển Ayrshare API. Trang này trình bày cách kết nối đến nó và cách hoạt động của xác thực.

​
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.

​
Các client được hỗ trợ

Action MCP Server chỉ xác thực bằng một header yêu cầu Authorization: Bearer tĩnh. Chính yêu cầu duy nhất đó quyết định mọi thứ bên dưới: một client có thể đặt header HTTP tùy chỉnh trên kết nối Streamable HTTP thì có thể xác thực, còn client không thể thì không. Hãy tìm client của bạn trước khi bắt đầu thiết lập.

​
Vì sao connector cá nhân không thể xác thực

Action MCP của Ayrshare yêu cầu một header Authorization: Bearer tĩnh. Việc thêm nó dưới dạng custom connector cá nhân trên claude.ai, Claude Desktop hoặc Claude mobile sẽ không hoạt động, vì Ayrshare không công bố metadata OAuth và phương án thay thế bằng header yêu cầu là một bản beta giới hạn cho các tổ chức được phê duyệt. Trên một connector cá nhân, không có cài đặt nào ở phía bạn khắc phục được điều này: không có trường nào cho header Authorization, và không có API key, profile hay cài đặt tài khoản nào bật được nó. Ayrshare không công bố metadata OAuth, vì vậy đường OAuth của connector không có gì để kết nối tới. Thay vào đó, hãy dùng một client từ bảng trên: Claude Code, plugin Claude Code, hoặc bất kỳ client nào cho phép bạn đặt header Authorization tùy chỉnh. Nếu bạn là quản trị viên của một tổ chức trong bản beta header yêu cầu của Anthropic, xem Các tổ chức Team và Enterprise bên dưới.
Nếu connector của bạn trông có vẻ ổn nhưng mọi công cụ đều thất bại. Connector được thêm vào suôn sẻ, báo trạng thái healthy, và liệt kê đầy đủ danh mục công cụ — rồi sau đó mọi lệnh gọi công cụ đều trả về lỗi 403 / code 102, “API Key not valid” của Ayrshare. Đó chính là giới hạn này, không phải khóa bị hỏng — client của bạn không thể gửi header Authorization: Bearer tĩnh mà server này yêu cầu. initialize và tools/list có thể truy cập được trước khi xác thực (xem Xác thực bên dưới), vì vậy không có gì thất bại cho đến lệnh gọi công cụ đầu tiên, khi rõ ràng là chưa từng có thông tin xác thực nào được gửi đi.Do khả năng của client, hay khóa thực sự không hợp lệ? Chúng trả về lỗi giống hệt nhau, vì vậy hãy dùng dấu hiệu đặc trưng để phân biệt. Lỗi do khả năng của client nghĩa là connector vẫn healthy và mọi công cụ đều thất bại, trong khi cùng khóa đó hoạt động bình thường ở nơi khác. Một khóa không hợp lệ tạo ra cùng lỗi nhưng có thể tái hiện bên ngoài connector — nó cũng thất bại trên một lệnh gọi REST. Về ngữ nghĩa của bản thân lỗi, xem Lỗi xác thực bên dưới.

​
Các tổ chức Team và Enterprise

Cơ chế static_headers của Anthropic cho phép một custom connector gửi một thông tin xác thực cố định dưới dạng header yêu cầu thay vì dùng OAuth. Nó có sẵn ở dạng beta cho quản trị viên tổ chức trong một tập hợp giới hạn các tổ chức, và không có sẵn cho người dùng cá nhân thêm connector cá nhân. Nếu tổ chức của bạn có quyền truy cập, quản trị viên phải nhập giá trị header là Bearer theo sau bởi API key Ayrshare của bạn, bao gồm cả dấu cách — Claude gửi giá trị chính xác như đã nhập và không tự thêm scheme cho bạn. Để biết tính khả dụng hiện tại và cách thiết lập, xem tài liệu xác thực connector của Anthropic.
Khóa được chia sẻ bởi toàn bộ tổ chức. Thông tin xác thực header yêu cầu của Anthropic được quản trị viên nhập một lần và được mọi thành viên của tổ chức sử dụng, vì vậy tất cả họ đều hành động như một tài khoản Ayrshare duy nhất mà khóa đó thuộc về — với quyền truy cập vào mọi User Profile bên dưới nó trên một khóa Business, và không có sự quy công theo từng người dùng trong lịch sử hoặc analytics Ayrshare của bạn. Hãy coi nó như một thông tin xác thực dịch vụ dùng chung, không phải quyền truy cập cá nhân.

​
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ụ mang isError: 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 và cho phép bạn đặt một header yêu cầu tùy chỉnh — xem Các client được hỗ trợ ở trên — hãy đăng ký server trực tiếp. Trong Claude Code:
Để nhắm tới một sub-profile trên mỗi lệnh gọi, hãy thêm header Profile-Key tùy chọn:
Kết nối MCP khởi tạo khi bắt đầu phiên. Khởi động lại client MCP của bạn sau khi cài đặt server hoặc thay đổi khóa để cấu hình mới có hiệu lực.

​
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 header Authorization (và Profile-Key tùy chọn) của bạn: Đây là các header tương tự được sử dụng bởi REST API — một cặp khóa OAuth 1.0a cho mỗi tài khoản Ayrshare, được gửi trên mọi yêu cầu nhắm tới X (cặp khóa tương tự áp dụng cho tất cả các sub-profile). Ayrshare không sử dụng OAuth 2.0 ở đây. Xem Tổng quan API và Hướng dẫn thiết lập X BYO Key để biết thiết lập, chính sách và xử lý sự cố.
Nếu không có các header này, một lệnh gọi công cụ X/Twitter sẽ trả về lỗi 419 (x_credentials_required).

​
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 header Authorization 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):
Khởi động lại client MCP của bạn sau khi thay đổi header để cấu hình mới có hiệu lực. Đang sử dụng plugin Claude Code thay vì kết nối thô? Xem Claude Code Plugin → Thông tin xác thực BYO cho X/Twitter.

​
Các bước tiếp theo

Danh mục Công cụ

33 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.