MCP e app do ChatGPT

O AutoPSEO executa um único servidor MCP (Model Context Protocol) em https://app.autopseo.com/mcp. Qualquer assistente que fale MCP por HTTP pode se conectar, seja entrando na sua conta do AutoPSEO, seja com uma chave de API apk_live_, e passa a trabalhar com as mesmas propriedades, permissões e plano que você. O servidor registra 72 ferramentas em três grupos: relatórios do Search Console e do GA4, dados de pesquisa e o motor de conteúdo, por meio do qual a sua própria IA pode escrever artigos para o seu site.

Conectar por login

As ferramentas que oferecem login MCP não precisam de chave. Adicione o endereço, entre no AutoPSEO quando a ferramenta pedir e aprove; a ferramenta passa a manter e renovar o próprio acesso.

• Claude Code: execute claude mcp add --transport http autopseo https://app.autopseo.com/mcp, depois digite /mcp, escolha autopseo e selecione Authenticate.
• Claude na web ou no desktop: Settings → Connectors → Add custom connector, cole https://app.autopseo.com/mcp, depois clique em Connect e faça login.
• Cursor: adicione o servidor a ~/.cursor/mcp.json (todos os projetos) ou a .cursor/mcp.json (um projeto) e use o botão Connect que o Cursor exibe ao lado dele.

{ "mcpServers": { "autopseo": { "url": "https://app.autopseo.com/mcp" } } }

Cada ferramenta conectada dessa forma aparece em Signed-in tools na página MCP & API, onde Sign out corta o acesso na hora. Um bom primeiro pedido é "Liste as propriedades do Search Console na minha conta": a resposta confirma que a conexão funciona e dá ao assistente os nomes exatos de propriedade que as outras ferramentas esperam.

ChatGPT

O ChatGPT se conecta pelo modo desenvolvedor, e a página MCP & API explica o passo a passo em ChatGPT app. Em resumo: no ChatGPT, abra Settings → Apps & Connectors → Advanced settings e ative Developer mode (o app lista os planos ChatGPT Plus, Pro, Business, Enterprise e Edu), escolha Create, dê um nome ao conector, defina a URL do servidor MCP como https://app.autopseo.com/mcp e a autenticação como OAuth, e entre no AutoPSEO quando o ChatGPT pedir. Os conectores do ChatGPT oferecem apenas OAuth ou nenhuma autenticação, portanto chaves de API não funcionam ali. Há mais detalhes na página do ChatGPT.

Conectar com uma chave de API

As chaves servem para scripts, tarefas agendadas e máquinas sem navegador. Em MCP & API → API keys, dê um nome à chave e escolha o escopo:

• Read only: consulta dados e executa relatórios; não pode adicionar, alterar nem excluir nada.
• Read & write: tudo o que uma chave de leitura faz, além das ferramentas que alteram dados ou gastam créditos de pesquisa.

A chave completa, apk_live_ seguido de 32 caracteres hexadecimais, é exibida uma única vez; o AutoPSEO armazena apenas o hash SHA-256 dela. A lista de chaves mostra quando cada uma foi criada, quando foi usada pela última vez e quantas requisições fez, e Revoke interrompe uma chave imediatamente. Você pode ter até 25 chaves ativas. Envie a chave como Authorization: Bearer apk_live_... (um cabeçalho x-api-key também funciona):

claude mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer apk_live_..."

A página também traz exemplos para a OpenAI Responses API, para JSON-RPC puro com curl (o servidor usa o transporte Streamable HTTP) e para a REST API em https://app.autopseo.com/v1, que oferece as 19 ferramentas do Search Console e do GA4 com as mesmas chaves e um documento OpenAPI 3.1 em /v1/openapi.json.

As ferramentas

A página MCP & API sempre lista os nomes atuais das ferramentas; quando esta página foi escrita, eram 72.

Search Console e GA4 (19 ferramentas)

list_properties, search_analytics, top_queries, top_pages, top_countries, compare_periods, content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings, url_inspection, sitemaps, annotations, create_annotation, ga4_overview, ga4_breakdown e ga4_key_events. Elas não consomem créditos. Sem datas, cobrem os últimos 28 dias consolidados em comparação com os 28 anteriores, e qualquer pessoa pode testá-las na propriedade de demonstração sc-domain:demo.autopseo.app. Apesar do nome, content_decay pertence a este grupo: ela encontra páginas que estão perdendo cliques.

Pesquisa (33 ferramentas)

• Conta e projetos: whoami, create_project, get_project_context, update_project_context
• Palavras-chave: research_keywords, get_keyword_metrics, get_ranked_keywords, get_domain_keyword_suggestions, save_keywords, list_saved_keywords
• Domínios, páginas de resultados e links: get_domain_overview, get_serp_results, find_serp_competitors, get_backlinks_overview, get_backlinks_profile
• Monitoramento de posições: create_rank_tracker, get_rank_tracker, add_rank_tracking_keywords, remove_rank_tracking_keywords, estimate_rank_tracker_cost, run_rank_tracker
• Busca local: search_local_businesses, get_local_serp_results, get_local_rank_grid, get_business_profile, get_business_reviews, get_business_updates, get_google_business_questions, list_business_categories
• Auditorias de site: run_site_audit, get_audit_status, get_audit_issues, get_audit_pages

Muitas dessas ferramentas compram dados da DataForSEO e consomem seus créditos de pesquisa; por isso, mantenha as requisições focadas e verifique antes de lotes grandes.

Motor de conteúdo (20 ferramentas)

Elas permitem que a sua própria IA trabalhe na mesma fila do redator do AutoPSEO: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish, content_unpublish, content_get_page, content_report, content_find_pages, content_add_topics, content_decline, content_merge, content_cover, content_set_cover, content_get_translation, content_submit_translation, content_instructions, content_propose_value, content_submit_value e content_remove_path. O servidor também oferece cinco prompts: write-articles, optimize-page, revise-draft, connect-repo e refresh-decayed.

Uma sessão típica lista as tarefas, reivindica uma (a reivindicação a reserva por duas horas), lê o briefing, escreve, envia e corrige o que as verificações devolverem, e só publica quando você mandar. Capas e traduções têm ferramentas próprias. Os artigos escritos assim passam pelas mesmas verificações dos do próprio AutoPSEO e não usam nada da sua cota de artigos, embora a primeira chamada de um briefing leia os resultados de busca ao vivo com créditos de pesquisa. O fluxo completo está em Escrever com a sua própria IA.

Ferramentas de leitura, escrita e pagas

Cada ferramenta tem uma classe de acesso. As ferramentas de leitura apenas consultam (33 delas), as de escrita alteram o seu espaço de trabalho (22) e as pagas só leem, mas compram dados de pesquisa (17). Uma chave somente leitura só pode chamar ferramentas de leitura. Um membro da equipe com acesso Read também só pode chamar ferramentas de leitura, qualquer que seja a chave ou o login que use, e cada membro acessa apenas as propriedades indicadas no convite (Compartilhamento e acesso da equipe).

Limites e erros

As chamadas são limitadas a 60 por minuto por chave e 1,000 por hora por conta, somando todas as suas chaves. Ao ultrapassar qualquer um dos limites, o servidor responde HTTP 429 com um cabeçalho Retry-After, e a maioria dos clientes espera e tenta de novo sozinha; os handshakes initialize e ping não contam. Quando um período de teste termina sem assinatura, as ferramentas respondem "subscription required". O provedor de um assistente recebe seus dados apenas para as requisições que você fizer; desconecte a ferramenta ou revogue a chave dela para interromper o acesso. Há mais exemplos na página do MCP do Search Console.