Documentação

Grok: conectar o AutoPSEO por MCP

Use o servidor MCP do AutoPSEO no Grok: adicione-o como conector personalizado no grok.com, registre-o no Grok Build ou anexe-o como ferramenta remota na API da xAI.

MCP e API3 min de leitura

O Grok acessa o AutoPSEO pelo mesmo servidor MCP que todos os outros assistentes, em https://app.autopseo.com/mcp. Não é preciso instalar nada específico para o Grok: a xAI permite anexar servidores MCP remotos em três lugares, no grok.com, no agente de terminal Grok Build e na API da xAI, e o AutoPSEO funciona em todos eles, com as ferramentas, as permissões e o plano da sua conta. Esta página traz os passos para cada um e o que verificar quando uma conexão falha.

Grok na web

O guia de conectores da xAI descreve os conectores personalizados em três passos:

Acesse grok.com/connectors.
Escolha New Connector e, em seguida, Custom.
Informe https://app.autopseo.com/mcp como URL do servidor MCP e conclua o login. A página de login e aprovação do AutoPSEO será aberta; aprove com a conta que contém as suas propriedades.

Segundo a xAI, os conectores estão disponíveis para todos os usuários do Grok e, nos planos Business e Enterprise, um administrador da equipe precisa provisionar o conector antes que os membros possam usá-lo. Depois de conectar, peça ao Grok: "liste as propriedades do Search Console na minha conta" para confirmar que ele acessou a conta certa e conhece os nomes exatos das propriedades.

Grok Build

O Grok Build, o agente de terminal da xAI, adiciona um servidor remoto com um único comando (guia de MCP da xAI):

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

Na primeira vez que uma ferramenta é usada, o Grok Build abre o login no navegador e armazena o token por conta própria. Em uma máquina sem navegador, passe uma chave de API e mantenha-a em uma variável de ambiente:

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

O Grok Build também carrega servidores configurados para o Claude Code (~/.claude.json), para o Cursor (.cursor/mcp.json) e no .mcp.json do projeto, de modo que um servidor do AutoPSEO que você já tenha adicionado ali aparece sem nenhum passo extra. Na interface, /mcps lista os servidores e permite autenticar um deles.

A API da xAI

Agentes criados com a API da xAI podem chamar o AutoPSEO como uma ferramenta MCP remota. A xAI oferece esse suporte no SDK nativo e na API Responses compatível com OpenAI, por Streamable HTTP, com server_url, server_label e um valor opcional authorization para o token (ferramentas MCP remotas). Uma entrada no array tools tem este formato:

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

A xAI não oferece suporte ao parâmetro require_approval da API Responses, portanto nada pausa para aprovação antes de uma ferramenta ser executada. Dê aos agentes uma chave Read only, a menos que eles precisem alterar algo: o AutoPSEO recusa uma chave somente leitura em todas as ferramentas que gravam dados ou consomem créditos de pesquisa.

Que acesso dar ao Grok

Uso	Conectar com
Perguntas em conversas no grok.com	Login
Grok Build no seu próprio computador	Login, ou uma chave em uma máquina sem navegador
Agentes autônomos na API da xAI	Uma chave Read only, ou Read & write quando o agente precisar agir

As conexões feitas por login aparecem em MCP & API, em Signed-in tools, onde você pode encerrar a sessão de cada uma; as chaves são revogadas na mesma página. Os grupos de ferramentas, as classes de acesso e os limites estão descritos em MCP & ChatGPT, e o guia de conexão do Grok traz exemplos de prompts.

Solução de problemas

O Grok não consegue acessar o servidor. A xAI exige um servidor acessível pela internet pública, o que é o caso do AutoPSEO; portanto, confira o endereço: informe https://app.autopseo.com/mcp exatamente como está, incluindo /mcp.
Nenhuma propriedade aparece. Peça a ferramenta whoami para ver qual conta do AutoPSEO a conexão usa. Se for a conta certa, conecte o Search Console nela primeiro.
Uma ferramenta é recusada. Uma chave somente leitura não pode gravar nem gastar créditos, e um membro da equipe com acesso Read só pode ler.
HTTP 429. Os limites são 60 chamadas por minuto por chave e 1,000 por hora por conta.
Assinatura necessária. O período de teste da conta terminou; escolha um plano em Subscription & billing.

As visitas que o Grok envia ao seu site são contabilizadas no relatório de LLM Traffic do GA4.