> ## 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. # Plugin Claude Code > Cài đặt plugin Ayrshare cho Claude Code để xuất bản, lên lịch và phân tích bài đăng xã hội từ trình soạn thảo của bạn — với xác thực trước khi xuất bản, lời nhắc xác nhận trước khi xuất bản, soạn thảo theo brand voice và đọc lại phân tích. Plugin Ayrshare cho Claude Code đóng gói cấu hình [MCP Server](/additional/mcp-action-server), một lệnh thiết lập, các agent, các skill và một hook an toàn. Khi được cài đặt, bạn có thể xuất bản bài đăng, lấy lịch sử và phân tích, quản lý profiles, và nhiều hơn nữa — trực tiếp từ Claude Code. Trước khi bất cứ điều gì được đăng, agent sẽ xác thực từng bài đăng theo quy tắc của mạng đích và yêu cầu bạn xác nhận, phát hiện các từ chối có thể tránh được ngay từ đầu. Lịch sử bài đăng có sẵn để khớp với brand voice và phân tích có thể được đọc lại để định hướng cho bài đăng tiếp theo. Plugin là mã nguồn mở. Xem repository để biết chi tiết bên trong: [ayrshare/ayrshare-social-media-api-claude-plugin](https://github.com/ayrshare/ayrshare-social-media-api-claude-plugin). ## Cài đặt ```bash theme={"system"} claude plugin marketplace add ayrshare/ayrshare-social-media-api-claude-plugin ``` ```bash theme={"system"} claude plugin install ayrshare@ayrshare ``` ### Phạm vi cài đặt | Phạm vi | Nơi áp dụng | | ----------------- | ------------------------------------------------------- | | Global (mặc định) | Mọi dự án trên máy này. | | `--scope local` | Dự án hiện tại, không commit vào git. | | `--scope project` | Dự án hiện tại, được commit và chia sẻ với đội của bạn. | CLI của Claude Code gọi phạm vi global là `--scope user`. ## Thông tin xác thực Cung cấp Ayrshare API key của bạn bằng một trong hai cách sau: Tệp `.mcp.json` được đóng gói của plugin đã khai báo header `Authorization` cùng với các header `Profile-Key` và X BYOK tùy chọn, mỗi header có giá trị mặc định rỗng (`${VAR:-}`), vì vậy bạn kích hoạt một header đơn giản bằng cách đặt biến môi trường tương ứng (Claude Code thay thế các giá trị khi khởi động). Để nhắm tới một sub-profile trên mỗi lệnh gọi, hãy đặt `AYRSHARE_PROFILE_KEY` (qua `/ayrshare:setup` hoặc khối `env` trong `settings.json` của bạn) và khởi động lại Claude Code; header `Profile-Key` được đóng gói sẽ mang nó và giữ trống (được coi là không cung cấp) khi không được đặt. Để nhắm tới một sub-profile cho một lệnh gọi duy nhất, hãy truyền một đối số công cụ `profileKey` (không cần thay đổi cấu hình). Bạn không cần chỉnh sửa `.mcp.json` được đóng gói và bạn không nên, vì `claude plugin update` sẽ ghi đè nó. MCP server khởi tạo khi bắt đầu phiên. **Khởi động lại Claude Code** sau khi cài đặt plugin hoặc thay đổi khóa của bạn. ### Thông tin xác thực BYO cho X/Twitter Đăng lên X/Twitter yêu cầu thông tin xác thực X Developer App của riêng bạn (yêu cầu bắt buộc X BYO-key, có hiệu lực từ ngày 31 tháng 3 năm 2026; xem [Tổng quan API](/apis/overview#xtwitter-byo-credentials)). Tệp `.mcp.json` được đóng gói đã khai báo cả hai header X BYOK với giá trị mặc định rỗng, bên cạnh `Authorization` và `Profile-Key`: ```json theme={"system"} "headers": { "Authorization": "Bearer ${AYRSHARE_API_KEY}", "Profile-Key": "${AYRSHARE_PROFILE_KEY:-}", "X-Twitter-OAuth1-Api-Key": "${X_TWITTER_OAUTH1_API_KEY:-}", "X-Twitter-OAuth1-Api-Secret": "${X_TWITTER_OAUTH1_API_SECRET:-}" } ``` Vì vậy bạn chỉ cần đặt các biến môi trường tương ứng (`X_TWITTER_OAUTH1_API_KEY`, `X_TWITTER_OAUTH1_API_SECRET`) qua `/ayrshare:setup` hoặc `env` trong `settings.json`, rồi **khởi động lại Claude Code**; bạn không chỉnh sửa `.mcp.json` được đóng gói (nó bị ghi đè khi `claude plugin update`). Đặt **cả hai** hoặc không đặt: nếu không đặt cả hai, một lệnh gọi X/Twitter sẽ trả về lỗi `419` (`x_credentials_required`); nếu chỉ đặt một, nó trả về lỗi `400`. Đây là một cặp khóa 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ùng cặp cho tất cả các sub-profile). Ưu tiên kết nối thô hơn plugin? Các header BYO tương tự có thể được truyền qua `claude mcp add --header` — xem [Kết nối & Thiết lập → Thông tin xác thực BYO cho X/Twitter](/additional/mcp-action-connect#xtwitter-byo-credentials). ## Nội dung được cung cấp ### Lệnh ### Agents ### Skills | Skill | Mục đích | | ---------------------------- | ----------------------------------------------------------- | | `getting-started` | Định hướng và kết nối cho lần sử dụng đầu tiên. | | `post` | Tạo, xác thực, cập nhật và thử lại bài đăng. | | `history` | Truy xuất lịch sử bài đăng và nền tảng. | | `analytics` | Kéo phân tích theo bài đăng và cấp tài khoản. | | `comments` | Đọc, thêm và trả lời bình luận. | | `messages` | Đọc và gửi tin nhắn trực tiếp và cấu hình tự động phản hồi. | | `profiles` | Tạo và liệt kê các sub-profile. | | `media` | Xác thực rằng các URL media có thể truy cập được. | | `generate` | Bản nháp nội dung bài đăng do AI tạo và đề xuất hashtag. | | `webhooks` | Đăng ký, hủy đăng ký và liệt kê các webhook. | | `errors` | Giải mã các mã lỗi Ayrshare. | | `draft-in-brand-voice` | Soạn thảo nội dung bài đăng theo brand voice nhất quán. | | `plan-and-schedule-campaign` | Lên kế hoạch và lên lịch một chiến dịch nhiều bài đăng. | ### Hook xác nhận Một hook `PreToolUse` yêu cầu xác nhận trước bất kỳ hành động xuất bản hoặc gửi nào. Nó bao gồm chính xác 7 công cụ sau: ## FAQ Có. Plugin chạy `validate_post` để dry-run nội dung của bạn theo quy tắc của từng mạng — độ dài, định dạng và yêu cầu media — trước khi xuất bản, để bạn phát hiện các từ chối có thể tránh được ngay từ đầu. Có. Một hook xác nhận `PreToolUse` yêu cầu bạn phê duyệt trước bất kỳ hành động xuất bản hoặc gửi nào: `create_post`, `update_post`, `retry_post`, `add_comment`, `reply_comment`, `send_message`, và `set_auto_response`. Có. Skill `draft-in-brand-voice` đọc lịch sử bài đăng của bạn để soạn thảo nội dung mới theo brand voice nhất quán. Nó chỉ tạo bản nháp — không có gì được xuất bản nếu không có xác nhận của bạn. Có. Các công cụ phân tích trả về các số liệu theo bài đăng và cấp tài khoản, để bạn có thể đọc lại kết quả và để chúng định hướng bài đăng tiếp theo của bạn. Một Ayrshare API key (khóa Business plan cho profiles và sub-profiles) và Claude Code. Cấu hình khóa với `/ayrshare:setup` hoặc biến môi trường `AYRSHARE_API_KEY`, sau đó khởi động lại Claude Code. Có. X/Twitter yêu cầu thông tin xác thực OAuth 1.0a của riêng bạn, được thêm dưới dạng hai header kết nối (`X-Twitter-OAuth1-Api-Key` và `X-Twitter-OAuth1-Api-Secret`). Xem [Thông tin xác thực BYO cho X/Twitter](#xtwitter-byo-credentials) ở trên. ## Các bước tiếp theo Xác thực, nhắm tới profile và thông tin xác thực BYO. 27 công cụ được nhóm theo miền, với phạm vi và mục đích.