ASOgenic MCP

npx add-mcp 'https://mcp.asogenic.com/mcp'

Conecte o ASOgenic e execute um passe de ASO

O ASOgenic é um servidor Model Context Protocol. Conecte seu cliente MCP com OAuth e, em seguida, forneça as credenciais do App Store Connect separadamente por meio de uma ferramenta de credencial autenticada. O ASOgenic pode pesquisar palavras-chave, validar metadados, gerenciar capturas de tela e preparar uma versão revisada para envio.

Com pressa? Cole https://asogenic.com/setup no seu cliente MCP. É um runbook em texto simples que qualquer cliente ou automação compatível pode seguir.

Como funciona

Três serviços, mantidos deliberadamente separados:

• Seu cliente MCP (qualquer assistente, ferramenta de codificação ou automação compatível com MCP) conecta-se ao endpoint MCP do ASOgenic. Clientes desktop e CLI interativos usam MCP OAuth. Clientes não supervisionados podem usar uma chave de API da plataforma.
• O servidor MCP do ASOgenic expõe as ferramentas. Clientes hospedados armazenam ou importam explicitamente uma chave do App Store Connect por meio das ferramentas de credencial autenticadas.
• Este painel gerencia o acesso à plataforma. Ele é separado do MCP OAuth e da etapa de credencial do App Store Connect.

Autenticação

Clientes interativos usam MCP OAuth padrão, mas suas superfícies de configuração não são intercambiáveis. Codex CLI e a extensão Codex IDE compartilham a configuração do MCP. Os plugins do ChatGPT Work, conectores de conta do Claude, Cursor e VS Code têm cada um seu próprio registro e estado de sessão. As chaves de API da plataforma permanecem disponíveis apenas para CI e automação não supervisionada.

Escolha seu cliente

Use exatamente uma configuração abaixo. Escolha a do produto que chamará o ASOgenic. Cada configuração interativa usa o mesmo endpoint HTTP Streamable, https://mcp.asogenic.com/mcp, com OAuth e sem cabeçalhos personalizados.

Codex CLI e extensão Codex IDE

Esses dois compartilham a configuração do MCP. Execute:

codex mcp add asogenic --url https://mcp.asogenic.com/mcp
codex mcp list
codex mcp login asogenic

Conclua o OAuth no navegador, depois inicie uma nova sessão do Codex CLI ou chat IDE e chame asogenic_auth_status. Um destino http://127.0.0.1:<port>/callback é o listener OAuth temporário do Codex. Isso é esperado e não é a URL do MCP.

Plugin de modo desenvolvedor do ChatGPT Work

Isso cria um plugin pessoal no ChatGPT Work. Ele não autentica o Codex CLI, a extensão Codex IDE ou outra superfície do Codex.

1. No ChatGPT, abra Configurações → Segurança e login e ative o Modo desenvolvedor.
2. Abra Plugins do ChatGPT, selecione + e crie um plugin chamado ASOgenic com URL https://mcp.asogenic.com/mcp e autenticação OAuth.
3. Revise as ferramentas descobertas, crie o plugin, abra-o e selecione + para instalá-lo.
4. Inicie um novo chat Work, ative/selecione o ASOgenic, conclua o OAuth e chame asogenic_auth_status.

Conexão separada: um codex mcp login bem-sucedido não autentica o plugin do ChatGPT. Atualize ou reconecte o plugin em Plugins do ChatGPT e inicie um novo chat Work. Usuários do Codex CLI/IDE seguem a seção Codex acima.

Claude Code

claude mcp add --transport http --scope user asogenic https://mcp.asogenic.com/mcp
claude mcp list
claude mcp get asogenic

Inicie claude, execute /mcp, escolha ASOgenic e conclua o OAuth no navegador. Execute /mcp novamente para confirmar que está conectado e, em seguida, chame asogenic_auth_status. Esses comandos são apenas para Claude Code.

Claude, Cowork e Claude Desktop

Para uma conta individual, abra Personalizar → Conectores → + Adicionar → Adicionar conector personalizado. Digite o nome ASOgenic e a URL https://mcp.asogenic.com/mcp, mantenha o método OAuth que o Claude descobrir e conclua o login. Em uma nova conversa, ative o ASOgenic em + → Conectores e chame asogenic_auth_status.

No Team ou Enterprise, um proprietário autorizado primeiro o adiciona em Configurações da organização → Conectores → Adicionar → Personalizado → Web. Cada membro então seleciona Conectar em Personalizar → Conectores. Conectores remotos usam essa interface de conta mesmo no Claude Desktop. Não use comandos do Claude Code ou configuração JSON do desktop.

Cursor IDE e Cursor Agent CLI

Adicione esta entrada somente de URL ao ~/.cursor/mcp.json global, ou ao .cursor/mcp.json apenas quando o escopo do projeto for intencional:

{ "mcpServers": { "asogenic": { "url": "https://mcp.asogenic.com/mcp" } } }

Ative o ASOgenic nas configurações MCP do Cursor, selecione Needs login, conclua o OAuth e inicie um novo chat Agent. Confirme que ele aparece em Ferramentas Disponíveis e chame asogenic_auth_status. Diagnósticos CLI: cursor-agent mcp list, cursor-agent mcp login asogenic e cursor-agent mcp list-tools asogenic.

VS Code com GitHub Copilot

1. Execute MCP: Add Server na Paleta de Comandos.
2. Escolha HTTP, digite https://mcp.asogenic.com/mcp e nomeie-o como asogenic.
3. Execute MCP: List Servers, inicie o ASOgenic e aprove o OAuth no navegador.
4. No modo Copilot Chat Agent, ative o ASOgenic por meio de Configure Tools, abra um novo chat e chame asogenic_auth_status.

Outros clientes MCP com capacidade OAuth

Adicione um servidor HTTP Streamable chamado asogenic com URL https://mcp.asogenic.com/mcp, deixe os cabeçalhos personalizados vazios e use a ação Connect, Sign in ou Authorize desse cliente. Conclua o OAuth no mesmo produto, abra uma nova sessão e chame asogenic_auth_status. Se um cliente interativo não suportar MCP OAuth, escolha um cliente compatível com OAuth. As chaves de API da plataforma são reservadas para automação não supervisionada. Não copie comandos ou tokens de outro produto.

CI e automação não supervisionada

Não tente OAuth interativo. Crie uma chave de API da plataforma ASOgenic, mantenha-a no gerenciador de segredos do job e use esta configuração de cabeçalho fixo:

{ "mcpServers": { "asogenic": { "url": "https://mcp.asogenic.com/mcp", "headers": { "Authorization": "Bearer <your key>" } } } }

Esta é a única configuração pública onde um cabeçalho bearer fixo é esperado. Nunca coloque valores da Apple nesta configuração de conexão.

Adicionar credenciais do App Store Connect

Após o OAuth, chame asogenic_auth_status. Se ele relatar asc_configured: false, a conexão ASOgenic funciona, mas o acesso à Apple não foi configurado.

1. Obtenha os três valores da Apple. No App Store Connect, abra Usuários e Acesso → Integrações → App Store Connect API. Use o Issuer ID da equipe, o Key ID da chave de API e a chave privada .p8 baixada. A Apple permite que esse arquivo seja baixado apenas quando a chave é criada. Um arquivo perdido exige uma chave substituta.
2. Confirme se existe um caminho de entrada privado. Use um campo de entrada de ferramenta secreto/privado documentado pelo cliente ou uma transferência de arquivo para ferramenta que não adicione a chave à conversa do modelo. Se o cliente não tiver esse recurso, pare e use outro cliente compatível ou entre em contato com o suporte. Nunca cole a chave em chat comum, comandos de shell, logs, tickets, controle de versão ou configuração MCP.
3. Envie-a apenas pela ferramenta de credencial. Informe ao usuário que enviar a ferramenta autoriza o serviço MCP hospedado do ASOgenic a receber a chave. Chame asogenic_store_asc_credential para uso hospedado persistente, ou asogenic_import_asc_key para um teste de uma sessão. As ferramentas de credencial nunca retornam material de chave privada. Se uma credencial persistente já existir, use asogenic_rotate_asc_credential apenas com aprovação explícita. O fluxo de trabalho completo de lançamento exige App Manager ou uma função Apple superior.
4. Verifique o acesso à Apple. Chame asogenic_auth_status novamente. Continue apenas quando asc_configured: true e asc_valid: true, depois chame asogenic_list_apps. A prontidão do serviço não prova acesso à conta.

O fluxo de trabalho de lançamento

A ordem que realmente leva um aplicativo nunca lançado pela revisão da Apple:

1. asogenic_auth_status: as credenciais funcionam.
2. asogenic_list_apps / asogenic_resolve_app: encontre o aplicativo. Mantenha o session_key.
3. asogenic_intake_product_context: registre o que o aplicativo é. Tudo a jusante depende disso.
4. Por localidade: asogenic_fetch_source → gere os campos você mesmo (asogenic_research_keywords, asogenic_assemble_locale, asogenic_get_field_spec são auxílios) → asogenic_validate_record → asogenic_approve_locale → asogenic_publish.
5. Configuração da loja, cada uma exigida antes do envio: categoria, classificação etária, direitos autorais da versão, declaração de direitos de conteúdo, informações de revisão (+ conta demo se o aplicativo precisar de login), preço base, capturas de tela para cada família de dispositivos que o aplicativo suporta.
6. asogenic_get_release_readiness: blockers deve estar vazio. Leia também o warnings (algumas lacunas de nome que o servidor não pode verificar).
7. asogenic_submit_for_review.

App Privacy não está nesta lista de propósito. O ASOgenic não pode concluir o questionário de App Privacy por meio deste fluxo de credencial. Configure e verifique-o na interface web do App Store Connect antes do envio.

Cotas e limites de taxa

Cada conta recebe 500 chamadas de ferramenta por mês. A cota é para toda a conta, abrangendo conexões OAuth e chaves de API da plataforma. A janela rola continuamente: chamadas antigas expiram. Elas não são redefinidas em uma data fixa. Limites de rajada de janela curta também se aplicam, atualmente cerca de 120 chamadas por minuto.

• RATE_LIMITED: um limite de rajada. Aguarde os retry_after_s segundos e continue.
• QUOTA_EXCEEDED: a cota mensal foi gasta. Ela se recupera conforme as chamadas mais antigas expiram.

Um passe de otimização completo (pesquisa de palavras-chave, metadados e publicação em algumas localidades) é de aproximadamente 50 a 100 chamadas, então uma chave gratuita cobre uso real e repetido.

Solução de problemas

Codex CLI ou IDE está configurado, mas o chat não tem ferramentas ASOgenic

Execute codex mcp list, confirme a URL exata e execute codex mcp login asogenic se necessário. Em seguida, inicie uma nova sessão CLI ou chat IDE. Não adicione um servidor duplicado.

O plugin do ChatGPT Work diz que a autenticação foi bem-sucedida, mas a descoberta de ação falhou

Abra Plugins do ChatGPT, abra o ASOgenic, selecione Refresh e confirme que a URL termina em /mcp. Revise as ferramentas descobertas, instale e ative o plugin no ChatGPT Work e inicie um novo chat Work. O login do Codex CLI não repara esta conexão.

Claude Code diz Needs authentication

Execute claude mcp get asogenic, depois autentique-se em /mcp em uma sessão interativa do Claude Code. Se a credencial estiver desatualizada, use Clear authentication lá ou claude mcp logout asogenic antes de fazer login novamente.

Claude ou Claude Desktop não mostra o conector

Confirme que ele existe em Personalizar → Conectores e está ativado no menu + → Conectores da conversa. Usuários Team/Enterprise podem precisar que um proprietário autorizado adicione o conector da organização primeiro. Não use JSON do desktop para este conector hospedado.

Cursor mostra Needs login ou nenhuma ferramenta ASOgenic

Mantenha a entrada mcp.json somente com URL, ative-a nas configurações MCP, selecione Needs login e abra um novo chat Agent. Use cursor-agent mcp list-tools asogenic para verificar a descoberta no Cursor Agent CLI.

VS Code lista o servidor, mas o Copilot Agent não pode usá-lo

Execute MCP: List Servers e inicie/ative o ASOgenic, aprove o OAuth e ative suas ferramentas em Configure Tools. Execute MCP: Reset Cached Tools após uma alteração de metadados.

Auth required ou no verified tenant for this request

Reconecte o produto e a superfície exatos que estão fazendo a chamada de ferramenta e tente novamente asogenic_auth_status em uma nova sessão. Não copie tokens OAuth entre clientes nem os cole no chat.

As ferramentas estão visíveis, mas a descoberta de ação falha

Use a recuperação específica do cliente acima, depois teste asogenic_list_capabilities, asogenic_get_server_info e, finalmente, asogenic_auth_status antes de tentar uma gravação. Um rótulo de build não é um status de autenticação.

Uma URL de consentimento retorna 404

Inicie uma nova ação OAuth no cliente atual. URLs de consentimento antigas, expiradas ou repetidas não devem ser reutilizadas.

asc_configured: false de asogenic_auth_status

O OAuth está conectado, mas nenhuma credencial da Apple está configurada para esta conta hospedada. Siga as verificações de entrada privada em Adicionar credenciais do App Store Connect, use asogenic_store_asc_credential e tente novamente a ferramenta de status.

asc_valid: false

As credenciais estão presentes, mas a Apple as rejeitou: par errado de key ID/issuer ID, chave revogada ou .p8 malformado.

As ferramentas retornam 401 ou “invalid token”

Para um cliente interativo, reconecte o OAuth nesse produto e tente novamente de uma nova sessão. Para um job não supervisionado, verifique ou gire a chave da plataforma no painel. Não mova tokens entre clientes.

HTTP 502 aparece brevemente

Tente novamente após o serviço se recuperar. Um 502 transitório não é evidência de que uma chave da Apple ou conta OAuth deva ser girada.

APP_PRIVACY_NO_API

Esperado. Veja a nota sobre App Privacy acima. Configure-o na interface web. Ainda com dúvidas? Consulte as Perguntas Frequentes ou fale conosco.