Grok: kết nối AutoPSEO qua MCP

Grok kết nối với AutoPSEO qua cùng một máy chủ MCP như mọi trợ lý khác, tại https://app.autopseo.com/mcp. Bạn không cần cài đặt gì riêng cho Grok: xAI cho phép gắn máy chủ MCP từ xa ở ba nơi, gồm grok.com, tác tử dòng lệnh Grok Build và xAI API, và AutoPSEO hoạt động ở cả ba với đúng các công cụ, quyền hạn và gói dịch vụ của tài khoản bạn. Trang này hướng dẫn từng cách và nêu những điểm cần kiểm tra khi kết nối không thành công.

Grok trên web

Hướng dẫn connector của xAI mô tả connector tùy chỉnh qua ba bước:

1. Truy cập grok.com/connectors.
2. Chọn New Connector, sau đó chọn Custom.
3. Nhập https://app.autopseo.com/mcp làm URL máy chủ MCP rồi hoàn tất đăng nhập. Trang đăng nhập và phê duyệt của AutoPSEO sẽ mở ra; hãy phê duyệt bằng tài khoản đang quản lý các property của bạn.

Theo xAI, mọi người dùng Grok đều có thể dùng connector, và với gói Business và Enterprise, quản trị viên nhóm phải cấp phát connector thì các thành viên mới dùng được. Sau khi kết nối, hãy nhờ Grok "liệt kê các property Search Console trong tài khoản của tôi" để xác nhận Grok đã kết nối đúng tài khoản và nắm được chính xác tên các property.

Grok Build

Grok Build, tác tử dòng lệnh của xAI, thêm máy chủ từ xa chỉ bằng một lệnh (hướng dẫn MCP của xAI):

grok mcp add --transport http autopseo https://app.autopseo.com/mcp

Lần đầu bạn dùng một công cụ, Grok Build sẽ mở trang đăng nhập trong trình duyệt và tự lưu token. Trên máy không có trình duyệt, hãy dùng API key và lưu nó trong một biến môi trường:

grok mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer ${AUTOPSEO_API_KEY}"

Grok Build cũng nạp các máy chủ được cấu hình cho Claude Code (~/.claude.json), cho Cursor (.cursor/mcp.json) và trong .mcp.json của dự án, nên máy chủ AutoPSEO bạn đã thêm ở đó sẽ xuất hiện mà không cần làm thêm gì. Trong giao diện của Grok Build, lệnh /mcps liệt kê các máy chủ và cho phép bạn xác thực từng máy chủ.

xAI API

Các tác tử xây dựng trên xAI API có thể gọi AutoPSEO như một công cụ MCP từ xa. xAI hỗ trợ cách này trong SDK gốc và trong Responses API tương thích OpenAI qua Streamable HTTP, với server_url, server_label và giá trị authorization tùy chọn để truyền token (công cụ MCP từ xa). Một mục trong mảng tools có dạng như sau:

{
  "type": "mcp",
  "server_label": "autopseo",
  "server_url": "https://app.autopseo.com/mcp",
  "authorization": "apk_live_..."
}

xAI không hỗ trợ tham số require_approval của Responses API, vì vậy không có bước dừng chờ phê duyệt nào trước khi một công cụ chạy. Hãy cấp cho tác tử key Read only trừ khi nó bắt buộc phải thay đổi dữ liệu: AutoPSEO từ chối key chỉ đọc đối với mọi công cụ ghi dữ liệu hoặc tiêu tốn credit nghiên cứu.

Nên cấp quyền truy cập nào cho Grok

Các kết nối được tạo bằng cách đăng nhập hiển thị tại MCP & API trong mục Signed-in tools, nơi bạn có thể đăng xuất từng kết nối; key cũng được thu hồi ở cùng trang này. Các nhóm công cụ, loại quyền truy cập và giới hạn được mô tả trong MCP & ChatGPT, còn hướng dẫn kết nối Grok có các câu lệnh gợi ý mẫu.

Khắc phục sự cố

• Grok không kết nối được với máy chủ. xAI yêu cầu máy chủ phải truy cập được từ internet công khai, và máy chủ của AutoPSEO đáp ứng điều này, vì vậy hãy kiểm tra lại địa chỉ: nhập https://app.autopseo.com/mcp chính xác, bao gồm cả /mcp.
• Không có property nào hiển thị. Hãy yêu cầu dùng công cụ whoami để xem kết nối đang dùng tài khoản AutoPSEO nào. Nếu đó đúng là tài khoản của bạn, hãy kết nối Search Console tại đó trước.
• Một công cụ bị từ chối. Key chỉ đọc không thể ghi dữ liệu hay tiêu tốn credit, và thành viên nhóm có quyền Read chỉ có thể đọc.
• HTTP 429. Giới hạn là 60 lệnh gọi mỗi phút cho mỗi key và 1,000 lệnh gọi mỗi giờ cho mỗi tài khoản.
• Cần đăng ký gói. Thời gian dùng thử của tài khoản đã kết thúc; hãy chọn một gói tại Gói đăng ký & thanh toán.

Các lượt truy cập mà Grok gửi đến trang web của bạn được tính trong báo cáo LLM Traffic của GA4.