O Notiamo tem um servidor MCP. Um agente de IA conectado a ele pode listar os comentários de um projeto, ler um comentário com a captura de tela e as fotos, responder, mudar o status e atribuí-lo a alguém. Você continua no comando: você escolhe o que ele pode alterar e pode pará-lo a qualquer momento.

Conectar um agente é tarefa da equipe da agência. Os clientes não veem esta parte.

Há duas formas de conectar:

  • Entrar com o Notiamo (a melhor): o agente abre uma página do Notiamo, você clica em Permitir e ele fica conectado. Não há chave para copiar nem para guardar.
  • Uma chave, para agentes que não conseguem entrar. Você a cria com um clique e a cola no agente.

Conectar com Entrar com o Notiamo

  1. Na barra lateral, abra Configurações › Agentes de IA. O primeiro cartão é Conecte seu agente de IA.
  2. Escolha o seu agente nas abas: Claude Code, Claude.ai ou ChatGPT, Cursor, Codex ou Outro. Cada aba mostra o que copiar.
  3. Siga os passos da aba. O agente então abre a página do Notiamo Conectar um aplicativo.
  4. Nessa página, escolha a Organização, O que ele pode alterar (Trabalhar no feedback vem marcado; escolha Total ou Personalizar para mais) e os Projetos. Clique em Permitir.

O agente agora aparece no cartão Aplicativos conectados. Atualize a página para vê-lo.

O cartão Conecte seu agente de IA nas Configurações do Notiamo, aba Agentes de IA: uma aba para cada agente e os passos para o Claude Code.O cartão Conecte seu agente de IA nas Configurações do Notiamo, aba Agentes de IA: uma aba para cada agente e os passos para o Claude Code.

A página do Notiamo “Conectar um aplicativo”: o nome do aplicativo, a organização, o que ele pode alterar, os projetos e os botões Permitir e Negar.A página do Notiamo “Conectar um aplicativo”: o nome do aplicativo, a organização, o que ele pode alterar, os projetos e os botões Permitir e Negar.

Claude Code

Execute isto uma vez em um terminal:

claude mcp add --scope user --transport http notiamo https://my.notiamo.com/api/mcp

Com --scope user, a conexão funciona em todas as suas pastas de código. Sem isso, ela só funciona na pasta onde você executou o comando.

Depois abra o Claude Code e digite /mcp. Escolha notiamo e depois Authenticate. O navegador abre a página do Notiamo: clique em Permitir.

Na pasta de código de um site, peça: “Mostre o feedback aberto do Notiamo para este projeto.” Ou execute o prompt /mcp__notiamo__work_on_feedback. Ele guia o agente pelos comentários, um por um: começar, corrigir, responder, concluir. O agente nunca fecha um comentário; o cliente confere e fecha.

Se você conectou antes de o Notiamo ter o nome atual, remova primeiro a conexão antiga com claude mcp remove sitereview.

Claude.ai, Claude desktop e ChatGPT

Abra Settings › Connectors no aplicativo e adicione um conector personalizado chamado Notiamo, com o endereço https://my.notiamo.com/api/mcp. Clique em Connect e depois em Permitir na página do Notiamo. Os passos para cada aplicativo estão em Agentes de IA pessoais.

Cursor e Codex

Os passos estão em Conectar o Cursor e Conectar o Codex.

Outros agentes

Um agente que consegue entrar em um servidor MCP (OAuth) precisa só do endereço https://my.notiamo.com/api/mcp. Ele encontra sozinho o login do Notiamo (em https://my.notiamo.com/.well-known/oauth-authorization-server).

Conectar com uma chave

Use uma chave quando o seu agente não consegue entrar.

  1. Abra Configurações › Agentes de IA e encontre o cartão Chaves de agente.
  2. Clique em Criar uma chave. A chave recebe escolhas seguras: Trabalhar no feedback, Todos os meus projetos, sem data de expiração, e um nome como “Chave de agente – 28 de outubro de 2026”.
  3. Para escolher você mesmo, abra antes Mais opções: o Nome da chave, o Acesso (Somente leitura, Trabalhar no feedback, Total ou Personalizar, veja O que um agente pode alterar), o Projeto (todos, ou só um: uma chave limitada a um projeto não vê nada dos outros) e quando ela Expira (nunca, em 30 dias ou em 90 dias).
  4. O cartão mostra Sua chave está pronta, com a configuração para Claude Code, Cursor e Outro, já com a chave. Copie-a agora: ela aparece uma única vez.

Para o Claude Code, o comando é assim:

claude mcp add --scope user --transport http notiamo https://my.notiamo.com/api/mcp --header "Authorization: Bearer YOUR_KEY"

Outros agentes: adicione um servidor MCP HTTP com o endereço https://my.notiamo.com/api/mcp e o cabeçalho Authorization: Bearer YOUR_KEY.

Uma chave age como você. Guarde-a como uma senha.

O que um agente pode alterar

Um agente sempre pode ler o feedback dos projetos a que tem acesso. O que ele pode alterar vem em oito grupos:

  • Notas: notas internas para a sua equipe.
  • Respostas: respostas que o seu cliente vê.
  • Status: mudar o status e atribuir.
  • Tarefas: adicionar e editar tarefas.
  • Configuração: espaços de trabalho, projetos e endereços.
  • Convites: convidar clientes. Convidar membros da equipe exige Total.
  • Cobrança: o teste, links de pagamento e novas organizações.
  • Mudanças: pedir para mover projetos e espaços de trabalho.

Três opções já vêm prontas: Somente leitura (nenhum grupo), Trabalhar no feedback (Notas, Respostas, Status e Tarefas) e Total (os oito). Com Personalizar, você marca os grupos por conta própria. Quando o agente tenta algo fora dos seus grupos, o Notiamo recusa com permission_missing e informa o grupo em permission; uma chave somente leitura recebe read_only.

Como o agente encontra o projeto certo

O agente procura o arquivo .notiamo.json na pasta de código. Baixe-o na página do projeto no Notiamo com Baixar .notiamo.json, ou deixe o Prompt de IA criá-lo (veja Instalar o widget). Sem esse arquivo, o agente pode comparar o endereço git da pasta com a configuração Repositório de código do projeto.

O que as pessoas veem

As respostas e alterações feitas por um agente são marcadas com o nome dele para a sua equipe, por exemplo (via Claude Code). O nome é o da chave ou do aplicativo. O cliente vê uma resposta normal. O agente também pode escrever notas internas, para detalhes técnicos.

Um comentário concluído por um agente de IA: a resposta dele diz o que mudou, e o histórico mostra que o agente respondeu e o marcou como concluído.Um comentário concluído por um agente de IA: a resposta dele diz o que mudou, e o histórico mostra que o agente respondeu e o marcou como concluído.

Parar um agente

Para um agente conectado com Entrar com o Notiamo, abra o cartão Aplicativos conectados em Configurações › Agentes de IA e clique em Desconectar. O aplicativo para de funcionar na hora; ele pode pedir que você o conecte de novo mais tarde.

Para uma chave, clique em Revogar ao lado dela no cartão Chaves de agente. Qualquer agente que a use para de funcionar na hora.

Para dar ao agente uma chave nova, clique em Substituir chave. A chave antiga deixa de funcionar, e o cartão mostra a nova uma única vez. Uma chave criada pelo cadastro de um agente aparece com a marca Cadastro por agente.

Deixe seu agente configurar tudo

Com Total, ou com os grupos Configuração, Convites e Cobrança, o agente também pode fazer a configuração sozinho. Veja Deixe um agente de IA configurar o Notiamo para você para saber o que você faz e Para agentes de IA para o guia técnico. As ferramentas:

  • get_account: mostra seu plano, os limites e o teste.
  • list_plans: lista os planos e o que cada um inclui.
  • get_billing: mostra os dados de cobrança (só para admins).
  • start_trial: inicia o teste gratuito de 14 dias do Studio, uma vez por pessoa (só para admins).
  • list_workspaces: lista seus espaços de trabalho.
  • create_workspace: adiciona um espaço de trabalho.
  • list_projects e find_project: listam seus projetos ou encontram o de um endereço web ou pasta de código.
  • create_project: adiciona um projeto a um espaço de trabalho, com ou sem endereço web.
  • update_project_address: muda o endereço web de um projeto.
  • get_install: dá o código de incorporação e os passos para o framework do projeto (só projetos com endereço web).
  • check_install: verifica se o widget já foi aberto no site do projeto.
  • invite: convida um cliente ou um membro da equipe por e-mail.
  • get_payment_link: cria um link de pagamento do Stripe e o envia para você por e-mail; você mesmo paga (só para admins).

No plano gratuito, seu primeiro projeto já existe após o cadastro, então create_project costuma responder plan_limit. O agente então usa update_project_address nesse projeto. Uma chave limitada a um projeto pode ler os dados de instalação e mudar o endereço desse projeto; ela não pode criar, convidar, iniciar um teste nem pedir pagamento.

Um agente também pode adicionar uma tarefa com create_task (projectId, title e, se quiser, text e pageUrl) e mudar o título ou o texto dela com update_task. Ambos contam para um limite diário de novos espaços de trabalho, projetos e tarefas; a recusa avisa quando você o atinge. Veja Tarefas.

Relatórios de trabalho

No Studio e no Agency, e durante o teste, seu agente pode redigir os relatórios de trabalho que seus clientes enviam: um artigo sobre o trabalho e depois as publicações para redes sociais. As ferramentas:

  • list_job_reports: lista os relatórios de trabalho dos seus projetos. state: "ready" dá os que aguardam um artigo; not_done dá todos, menos os finalizados.
  • get_comment: lê um relatório, com os fatos do trabalho, os arquivos por fase (antes, durante, depois, outros) com suas legendas e ids e, enquanto o artigo aguarda, o link de aprovação.
  • reply com role: "article": publica o artigo, no idioma do relatório de trabalho. O estado passa a Artigo aguardando aprovação.
  • request_approval: envia o link de aprovação por e-mail. Por padrão, para a pessoa atribuída, quando for uma pessoa cliente do espaço de trabalho; senão, para o autor da tarefa. to: "author", to: "assignee" ou to: "client" (todas as pessoas cliente do espaço de trabalho) permitem escolher. Uma vez por tarefa por hora; um envio em que nenhum e-mail saiu não conta.
  • reply com role: "posts" e files (os ids das fotos a usar): publica as publicações para redes sociais, depois que o artigo é aprovado.
  • update_file: define a fase ou a legenda de um arquivo. Uma legenda escrita assim mostra IA — confira; o Notiamo não escreve legendas por conta própria.
  • create_task e update_task aceitam jobReport, para transformar uma tarefa em relatório de trabalho ou mudar os fatos dele.

Só uma pessoa aprova um artigo: o cliente ou um membro da equipe que pode escrever no projeto. Um agente nunca aprova; ele entrega à pessoa o link de aprovação ou chama request_approval. As pessoas publicam as postagens nas redes sociais à mão. update_file exige o grupo Tarefas; reply e request_approval exigem Respostas. Os webhooks enviam cada mudança como job.state_changed (veja Webhooks e chaves de API).

Notas de voz, legendas e notas de tempo

No Studio e no Agency, e durante o teste, get_comment também traz o que a IA acrescentou aos arquivos:

  • Uma gravação aparece com um link para o áudio e a transcrição (Transcript (fr), by AI: "…"). Uma transcrição posterior aparece como não publicada.
  • Uma legenda de IA é marcada com (AI, not checked) até que uma pessoa a confira ou edite.
  • Um vídeo com mais de uns 20 segundos tem notas de tempo, uma por linha: 0:00–0:12 wide view of the room. Seu agente pode apontar à equipe um momento específico. Os clientes nunca veem as notas de tempo.
  • Quando a IA não conseguiu processar um arquivo, a resposta diz isso com as palavras simples que as pessoas veem, com um código de referência como AI-1A2B3C4D para passar ao suporte. Ela nunca mostra um erro técnico.

list_plans e get_billing dão os minutos de voz e de IA por mês. Veja Tarefas.

Só o que mudou

list_comments aceita since: um horário UTC ou o cursor da última resposta. O agente então recebe só os comentários e as tarefas que mudaram desde então, em um projeto ou em todos os seus projetos. Um agente que verifica toda manhã guarda o cursor e não relê tudo de novo.

list_activity conta o que aconteceu desde um horário: cada novo comentário ou tarefa, cada resposta com o texto, cada mudança de status e atribuição, com quem fez e quando. Para a equipe, mostra também as pessoas que entraram. Ele aceita o mesmo since e devolve um cursor. Peça ao seu agente: “Conte o que aconteceu nos meus projetos desde segunda-feira.”