문서

Grok: MCP로 AutoPSEO 연결하기

Grok에서 AutoPSEO의 MCP 서버를 사용하세요. grok.com에서 커스텀 커넥터로 추가하거나, Grok Build에 등록하거나, xAI API에서 원격 도구로 연결할 수 있습니다.

MCP & API2분 소요

Grok은 다른 AI 어시스턴트와 같은 MCP 서버(https://app.autopseo.com/mcp)를 통해 AutoPSEO에 연결됩니다. Grok 전용으로 설치할 것은 없습니다. xAI는 grok.com, 터미널 에이전트인 Grok Build, xAI API의 세 곳에서 원격 MCP 서버를 연결할 수 있게 해 주며, AutoPSEO는 어느 곳에서든 계정의 도구, 권한, 요금제 그대로 동작합니다. 이 페이지에서는 각 환경별 연결 방법과 연결이 실패할 때 확인할 사항을 안내합니다.

웹에서 Grok 사용하기

xAI의 커넥터 가이드는 커스텀 커넥터를 다음 세 단계로 설명합니다.

grok.com/connectors로 이동합니다.
New Connector를 선택한 다음 Custom을 선택합니다.
MCP 서버 URL에 https://app.autopseo.com/mcp을 입력하고 로그인을 완료합니다. AutoPSEO의 로그인 및 승인 페이지가 열리면, 속성(property)을 보유한 계정으로 승인하세요.

xAI에 따르면 커넥터는 모든 Grok 사용자가 쓸 수 있으며, Business 및 Enterprise 요금제에서는 팀 관리자가 먼저 커넥터를 프로비저닝해야 구성원이 사용할 수 있습니다. 연결이 끝나면 Grok에 "내 계정의 Search Console 속성 목록을 보여줘"라고 요청해 보세요. 올바른 계정에 연결되었는지, 정확한 속성 이름을 인식했는지 확인할 수 있습니다.

Grok Build

xAI의 터미널 에이전트인 Grok Build에서는 명령어 하나로 원격 서버를 추가할 수 있습니다(xAI의 MCP 가이드).

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

도구를 처음 사용할 때 Grok Build가 브라우저에서 로그인 창을 열고 토큰을 직접 저장합니다. 브라우저가 없는 환경에서는 대신 API 키를 전달하고, 키는 환경 변수에 보관하세요.

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

Grok Build는 Claude Code(~/.claude.json)와 Cursor(.cursor/mcp.json)에 설정된 서버, 그리고 프로젝트의 .mcp.json에 설정된 서버도 함께 불러옵니다. 따라서 이미 그곳에 추가해 둔 AutoPSEO 서버는 별도 작업 없이 바로 나타납니다. Grok Build 화면에서 /mcps를 입력하면 서버 목록을 확인하고 서버를 인증할 수 있습니다.

xAI API

xAI API로 만든 에이전트는 AutoPSEO를 원격 MCP 도구로 호출할 수 있습니다. xAI는 네이티브 SDK와 OpenAI 호환 Responses API에서 Streamable HTTP 방식으로 이를 지원하며, server_url, server_label, 그리고 토큰을 담는 선택 항목 authorization 값을 사용합니다(원격 MCP 도구). tools 배열의 항목은 다음과 같은 형태입니다.

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

xAI는 Responses API의 require_approval 매개변수를 지원하지 않으므로, 도구가 실행되기 전에 승인을 위해 멈추는 단계가 없습니다. 에이전트가 무언가를 변경해야 하는 경우가 아니라면 읽기 전용(Read only) 키를 부여하세요. AutoPSEO는 쓰기 작업을 하거나 리서치 크레딧을 소모하는 모든 도구에서 읽기 전용 키를 거부합니다.

Grok에 부여할 접근 권한

용도	연결 방식
grok.com 채팅에서 질문하기	로그인
내 컴퓨터에서 Grok Build 사용	로그인, 또는 브라우저가 없는 환경에서는 키
xAI API에서 무인으로 실행되는 에이전트	읽기 전용(Read only) 키, 에이전트가 직접 작업해야 하면 읽기 및 쓰기(Read & write) 키

로그인으로 만든 연결은 MCP & API 페이지의 로그인한 도구(Signed-in tools) 아래에 표시되며 여기서 로그아웃할 수 있습니다. 키 폐기도 같은 페이지에서 할 수 있습니다. 도구 그룹, 접근 등급, 사용 한도는 MCP & ChatGPT에서 설명하며, Grok 연결 가이드에서 예시 프롬프트를 볼 수 있습니다.

문제 해결

Grok이 서버에 연결하지 못합니다. xAI는 공용 인터넷에서 접근할 수 있는 서버를 요구하며 AutoPSEO 서버는 이 조건을 충족하므로, 주소를 확인하세요. /mcp까지 포함해 https://app.autopseo.com/mcp을 정확히 입력해야 합니다.
속성이 표시되지 않습니다. whoami 도구를 요청해 연결이 어느 AutoPSEO 계정을 사용하는지 확인하세요. 올바른 계정이라면 먼저 해당 계정에서 Search Console을 연결하세요.
도구 실행이 거부됩니다. 읽기 전용 키는 쓰기 작업이나 크레딧 사용이 불가능하며, 읽기(Read) 권한을 가진 팀 구성원은 조회만 할 수 있습니다.
HTTP 429. 한도는 키당 분당 60회, 계정당 시간당 1,000회입니다.
구독이 필요합니다. 계정의 체험 기간이 끝났습니다. 구독 및 결제에서 요금제를 선택하세요.

Grok이 사이트로 보낸 방문은 GA4의 LLM 트래픽 보고서에 집계됩니다.