---
title: "Menciona para Agentes — MCP e API de agentes"
description: "Agentes de IA podem se registrar, assinar e consultar dados de visibilidade em IA de forma autônoma via checkout atômico ACP."
lang: pt-BR
---
# Sua visibilidade em IA, feita para agentes

Aponte qualquer agente compatível com MCP para a Menciona para consultar ou corrigir os dados de visibilidade em IA da sua marca. Agentes podem se registrar e assinar de forma autônoma via checkout atômico ACP — sem humano.

## O que os agentes podem acessar

Todas as métricas do dashboard, disponíveis de forma programática.

- **Visibilidade de marca** — Taxa de menções e sentimento no ChatGPT, Claude, Gemini, Perplexity e mais.
- **Concorrentes** — Visibilidade e tendências lado a lado com as marcas que você concorre.
- **Prompts monitorados** — As perguntas reais que compradores fazem às IAs: listadas, criadas e atualizadas.
- **Fontes e comunidade** — Quais domínios e discussões geram suas citações.
- **Auditorias e correções** — Notas de auditoria do site, verificações que falham e uma lista priorizada do que corrigir primeiro.

## O pipeline atômico do agente

Um único POST em `/complete` cria a conta, assina o plano e devolve uma chave de API de longa duração — registro e pagamento em uma única chamada, sem humano.

### 1. Descobrir

Leia `/auth.md`, o bloco `agent_auth` em `https://api.menciona.ai/.well-known/oauth-authorization-server`, ou o feed ACP em `https://app.menciona.ai/api/acp/feed` para encontrar os planos disponíveis e o endpoint de checkout. O feed também retorna uma `publishable_key` (`pk_…`, segura para uso público) necessária para o próximo passo. Cada oferta traz um bloco `includes` — `monitoring_prompts`, `audited_websites`, `audit_runs_per_month`, `projects` — para você escolher o plano pelo conteúdo, não só pelo preço. O api-catalog em `/.well-known/api-catalog` fornece uma âncora legível por máquina para todas as superfícies ACP.

### 2. Tokenizar o cartão

Use a `publishable_key` do feed para criar um PaymentMethod reutilizável no Stripe. Os dados do cartão vão diretamente ao Stripe, nunca à Menciona. `allow_redisplay=always` é OBRIGATÓRIO para que o cartão possa ser reutilizado nas renovações.

```bash
curl https://api.stripe.com/v1/payment_methods \
  -u "$PUBLISHABLE_KEY:" \
  -d type=card \
  -d "card[number]=4242424242424242" \
  -d "card[exp_month]=12" -d "card[exp_year]=2030" -d "card[cvc]=123" \
  -d allow_redisplay=always
# → { "id": "pm_…", ... }
```

### 3. Abrir uma sessão de checkout

```http
POST https://app.menciona.ai/api/acp/checkout_sessions
Content-Type: application/json

{ "plan_price_id": "<do feed>" }
```

Resposta: um objeto `CheckoutSession` com `id` (`cs_…`).

### 4. Completar (registrar + pagar — atômico)

```http
POST https://app.menciona.ai/api/acp/checkout_sessions/{id}/complete
Content-Type: application/json

{
  "buyer":        { "email": "agent@example.com" },
  "payment_data": { "token": "pm_…", "provider": "stripe" },
  "consent":      { "recurring": true }
}
```

Resposta de sucesso — uma chave de API de longa duração emitida de forma atômica por essa única chamada:

```json
{
  "workspace_id":    "…",
  "subscription_id": "sub_…",
  "access_token":    "menciona_…",
  "token_type":      "Bearer"
}
```

> Cartões que exigem 3D Secure (principalmente na UE/UK) não conseguem completar o processo de forma autônoma — a chamada retorna `requires_3ds`; tente com outro cartão. Um e-mail que já tem um workspace na Menciona retorna `409 requires_sign_in` — use outro e-mail para um novo workspace anônimo, ou faça login em app.menciona.ai.

**Modelo de e-mail:** Use um endereço real para que um humano possa recuperar o workspace via redefinição de senha em app.menciona.ai. Use qualquer outro endereço para uma conta totalmente anônima. Escolha conforme suas necessidades operacionais.

**Tipo de credencial:** O `access_token` é uma **chave de API de longa duração** (prefixo `menciona_`), não um token OAuth. Não há `expires_in` nem `refresh_token` — a chave é válida indefinidamente até ser revogada.

**Nota sobre recorrência:** O campo `consent.recurring: true` autoriza o mandato de pagamento reutilizável criado durante o checkout. As renovações da assinatura são gerenciadas no servidor; o agente não precisa reautorizar a cada ciclo de cobrança.

### 5. Operar

Adicione a chave como token bearer em todas as requisições:

```
Authorization: Bearer menciona_…
```

Use a chave com o servidor MCP (`https://api.menciona.ai/mcp`). Renovações são gerenciadas no servidor — sem loop de refresh. Se você usa o servidor por HTTP puro, envie um `initialize`, depois `tools/list` para descobrir todas as ferramentas (incluindo `feedback.submit` para reportar problemas) e então `tools/call` — o handshake JSON-RPC completo está no [guia MCP](/pt-br/mcp/).

### 6. Quando prompts e auditorias rodam (e quota)

Criar um projeto dispara a primeira auditoria do site imediatamente, e criar um prompt dispara a primeira execução imediatamente; ambos passam a rodar em uma **agenda diária**. O trabalho roda em segundo plano e não é instantâneo — normalmente fica pronto em alguns minutos (até ~15 para sites grandes) — então faça **polling** em vez de assumir que um resultado vazio significa "sem dados":

- **Auditoria do site** — faça polling em `audits.list` / `audits.get` até o `status` ser `done` (o status terminal de sucesso; uma auditoria que terminou com alguns erros de verificação também é reportada como `done`). Uma `audits.list` vazia logo após criar o projeto significa *ainda não pronta*, não *sem auditoria*.
- **Resultados de prompts** — as métricas de visibilidade e concorrentes aparecem quando a execução termina (`brand_visibility.get` / `sources.get`). `no_runs_yet` significa volte em breve, não que a marca não tem cobertura.

**Limites de quota:** prompts e auditorias só executam enquanto a conta está dentro da quota do plano. Os prompts param de rodar no dia ao atingir o **limite diário de prompts** (`includes.monitoring_prompts`); auditorias só rodam para projetos dentro das **vagas de sites auditados** (`includes.audited_websites`) e enquanto houver **créditos mensais de auditoria** (`includes.audit_runs_per_month`). Escolha um plano cujo `includes` atenda às suas necessidades.

## Deixe seu agente corrigir no seu repositório

A Menciona não só aponta os problemas. Abra seu agente de código dentro do repositório do seu site, conecte o MCP da Menciona e peça para ele trabalhar na auditoria. Ele lê o que está falhando e edita os arquivos (schema, metadados, estrutura) que fazem os motores de IA citarem você.

1. **Abra seu agente no repositório** — Claude Code, Cursor, Copilot, o que seu time já usa, no código do seu site.
2. **Conecte o MCP da Menciona** — Uma linha de configuração e seu agente lê suas auditorias, notas e correções priorizadas.
3. **Peça para trabalhar a auditoria** — Ele puxa as verificações que falham e edita os arquivos para corrigir, e você revisa o diff.

Você diz: *"Conecte na Menciona, puxe minha auditoria mais recente e corrija os problemas abertos neste repositório."*

## Conecte em duas chamadas

Aponte qualquer cliente MCP para o servidor da Menciona, ou registre-se e assine de forma autônoma pelo fluxo de checkout ACP. Descubra os planos disponíveis em `/auth.md`, no bloco `agent_auth`, no api-catalog ou no feed ACP.

```json
{
  "mcpServers": {
    "menciona": {
      "url": "https://api.menciona.ai/mcp",
      "headers": {
        "Authorization": "Bearer menciona_…"
      }
    }
  }
}
```

## Descoberto por design

Agentes e LLMs podem ler como trabalhar com a Menciona a partir de manifestos legíveis por máquina servidos no domínio raiz.

- `/auth.md` — Receita de registro de agentes
- `https://api.menciona.ai/.well-known/oauth-authorization-server` — Bloco agent_auth (no host da API)
- `/.well-known/api-catalog` — Catálogo de APIs (RFC 9727)
- `https://app.menciona.ai/api/acp/feed` — Feed de produtos ACP (USD; servido pelo host do app, não pelo domínio raiz)
- `/.well-known/agent-skills/index.json` — Manifesto de skills
- `/.well-known/mcp/server-card.json` — Cartão do servidor MCP
- `/.well-known/openapi.json` — Especificação OpenAPI do checkout ACP
- `/llms.txt` — Mapa do site para LLMs

## Aponte seu agente para a Menciona

Mostre ao seu agente como cada modelo de IA fala sobre sua marca.

Começar: https://app.menciona.ai/signup