Kết nối Search Console với Claude

Claude Desktop

Mở Settings, sau đó Connectors, rồi Add custom connector, và dán endpoint AutoPSEO tại https://app.autopseo.com/mcp. Claude sẽ tải danh sách công cụ ngay khi kết nối, nên một kết nối thành công sẽ hiển thị các công cụ ngay lập tức.

• Streamable HTTP, không cần cài đặt tiến trình cục bộ nào
• Xác thực qua trình duyệt, hoặc dán khóa bearer có dạng apk_live_ theo sau là 32 ký tự hex
• Yêu cầu danh sách tài sản trước để xác nhận connector đã kết nối với tài khoản nào

Claude Code

Từ terminal, đăng ký máy chủ một lần bằng claude mcp add, chọn giao thức truyền tải http và cùng endpoint đó. Trong một phiên làm việc, lệnh /mcp cho biết máy chủ đã kết nối hay chưa và những công cụ nào được cung cấp.

• Phạm vi project cho một kho lưu trữ, phạm vi user cho tất cả các kho lưu trữ
• Lưu khóa trong biến môi trường thay vì trong file cấu hình đã commit
• Hữu ích khi đặt cạnh trang bạn đang chỉnh sửa, để agent đọc hiệu suất của trang đó trước khi viết lại

Yêu cầu phân tích theo đúng tên gọi

Việc chọn công cụ sẽ chính xác hơn nhiều khi prompt nêu rõ tên báo cáo. "Chạy phân tích cannibalization cho tài sản này" hiệu quả hơn "kiểm tra trùng lặp từ khóa", vì câu đầu ánh xạ đến một công cụ duy nhất còn câu sau có thể ánh xạ đến nhiều công cụ.

• "Những trang nào mất nhiều lượt nhấp nhất so với 28 ngày trước đó?"
• "Hiển thị các truy vấn striking-distance ở vị trí từ 4 đến 10"
• "So sánh tháng trước với cùng kỳ năm ngoái"
• "Những truy vấn nào đã rớt khỏi top 100 trong tháng này?"

Phạm vi mà kết nối có thể truy cập

Chỉ những tài sản mà tài khoản AutoPSEO của bạn đã có quyền đọc. Khóa chỉ đọc hoàn toàn không thể gọi công cụ ghi, nên dù prompt có thế nào — từ bạn hay từ một trang mà Claude tình cờ đọc được — cũng không thể khiến nó thay đổi bất cứ điều gì.

Khi không kết nối được

Claude gọi máy chủ từ chính hạ tầng của mình, nên địa chỉ localhost hoặc địa chỉ riêng tư sẽ bị từ chối. Hãy dùng đúng endpoint được lưu trữ như đã ghi, kể cả đường dẫn /mcp, và kiểm tra xem khóa có bị thu hồi trong mục Account, MCP API keys hay không.