> ## 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. # Kết nối tới MCP Server > Kết nối bất kỳ client MCP nào tới Ayrshare MCP Server — transport, endpoint và xác thực. [MCP Server](/additional/mcp-action-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. ## 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. ### 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](/additional/mcp-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: ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` Để 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: ```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" ``` 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: | 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 | Đâ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](/apis/overview#xtwitter-byo-credentials) và [Hướng dẫn thiết lập X BYO Key](/dashboard/connect-social-accounts/x-twitter-byo-keys) để 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): ```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" ``` ### 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`): ```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" ``` 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](/additional/mcp-claude-code-plugin#xtwitter-byo-credentials). ## Các bước tiếp theo 27 công cụ được nhóm theo miền, với phạm vi và mục đích. Cài đặt plugin Ayrshare cho Claude Code.