Referência · Servidor MCP

As 26 ferramentas do servidor MCP do anota

Isto é exatamente o que o Claude e o Claude Code podem fazer na sua conta do anota: cada ferramenta, o que ela precisa e um exemplo de como pedir.

Endpoint
https://anota.cloud/mcp
Autenticação
Authorization: Bearer anota_sk_… Sua chave de API do anota.

Formulários

Criar, consultar, editar, publicar e mandar para a lixeira. As mudanças ficam no rascunho até você publicar.

list_forms

Somente leitura

Lista os formulários do seu espaço de trabalho (rascunhos e publicados, sem os arquivados) com status, número de respostas e link público.

EntradasNenhuma

Peça assim Quais formulários eu tenho e quantas respostas cada um recebeu?

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Lists all forms in the workspace (drafts and published; archived forms are excluded), most recently updated first. Each row includes the form id to use with the other tools, its status, submission count, and the public fill-out URL.

readOnlyHint: true

get_form

Somente leitura

Mostra a estrutura completa do rascunho de um formulário: páginas, campos, opções e regras de lógica.

Entradas
  • formId

Peça assim Mostre os campos do formulário de inscrição.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Gets a form's full structure from its current draft: title, status, PDF template, every page with its fields (id, type, label, required flag, and the option values/labels of choice fields), and every conditional logic rule (id, conditions, actions) currently on the form, plus its email notifications (id, type, enabled flag, recipients) and a note saying who is emailed when a submission arrives.

readOnlyHint: true

formId string · obrigatório
Form id (GUID).

create_form

Modifica dados

Cria um formulário novo como rascunho privado, com título e campos em uma única página.

Entradas
  • title
  • fields
  • descriptionopcional
  • languageopcional

Peça assim Crie um formulário de contato com nome, e-mail e mensagem.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Creates a new draft form with the given title and fields on a single page. Choice fields (dropdown, radio, checkbox) need 'options'; matrix fields take 'rows' and 'columns'. The form starts as a private draft — the owner can refine it at the returned builder URL, and publishing it makes it publicly fillable.

readOnlyHint: false · destructiveHint: false

title string · obrigatório
Form title shown to respondents, e.g. "Solicitud de empleo".
fields array · obrigatório
Fields to add, in display order.
description string · opcional
Optional intro text shown at the top of the form, under the title.
language string · opcional
The language the title and field texts are written in: "es" (Spanish, the default), "en" (English) or "pt" (Portuguese). It becomes the form's base language, which respondents, emails and PDFs fall back to.

add_fields

Modifica dados

Adiciona campos ao final do rascunho. Funciona também em formulários publicados; as mudanças entram no ar ao publicar de novo.

Entradas
  • formId
  • fields

Peça assim Adicione um campo de telefone opcional ao formulário de contato.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Appends fields to the end of a form's draft (its last page). Uses the same field format as form creation. Changes affect the draft only and go live when the form is published.

readOnlyHint: false · destructiveHint: false

formId string · obrigatório
Form id (GUID).
fields array · obrigatório
Fields to append, in display order.

edit_field

Destrutivo

Substitui a definição de um campo, mantendo o id e a posição. Só em formulários que nunca foram publicados: ao publicar, os campos ficam bloqueados.

Entradas
  • formId
  • fieldId
  • field

Peça assim Mude o campo «Tamanho» para uma lista suspensa com P, M e G.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Replaces an existing field's definition (type, label, required, options, etc.) in a form's draft, keeping its id and position. Only allowed while the form has never been published — once a form is published its existing fields are locked, since respondents may already have submitted answers shaped by them; appending new fields still works on a published form's draft. Uses the same field format as form creation.

readOnlyHint: false · destructiveHint: true

formId string · obrigatório
Form id (GUID).
fieldId string · obrigatório
Id of the field to replace (e.g. "f_a1b2c3").
field object · obrigatório
The field's new definition, replacing the old one entirely.

delete_field

Destrutivo

Remove um campo do rascunho e o retira das regras de lógica que o usavam. Só em formulários que nunca foram publicados.

Entradas
  • formId
  • fieldId

Peça assim Remova o campo «Empresa» do formulário de cadastro.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Removes a field from a form's draft. Only allowed while the form has never been published — once a form is published its existing fields are locked, since respondents may already have submitted answers for them. If any logic rule referenced this field, that reference is stripped from the rule (and the rule itself removed if nothing is left of it) rather than blocking the delete.

readOnlyHint: false · destructiveHint: true

formId string · obrigatório
Form id (GUID).
fieldId string · obrigatório
Id of the field to delete (e.g. "f_a1b2c3").

rename_form

Modifica dados

Muda o título de um formulário. As respostas não mudam; o link público acompanha o novo título só enquanto o formulário nunca foi publicado.

Entradas
  • formId
  • newTitle

Peça assim Renomeie a pesquisa para «Pesquisa de satisfação 2026».

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Renames a form. Existing submissions are never affected. The public URL (slug) follows the new title while the form has never been published; once it has been published the URL stays the same, since people may already have the link.

readOnlyHint: false · destructiveHint: false · idempotentHint: true

formId string · obrigatório
Form id (GUID).
newTitle string · obrigatório
The new form title.

clone_form

Modifica dados

Duplica um formulário como rascunho novo com outro link público, sem copiar respostas. É o jeito de mudar os campos bloqueados de um formulário publicado.

Entradas
  • formId

Peça assim Duplique o formulário de pedidos para eu poder mudar os campos.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Duplicates a form: the clone is a new Draft with a fresh public URL, copying the source's current draft (pages, fields, logic rules, PDF template). Versions and submissions are not copied. Because the clone has never been published, all of its fields are editable — cloning is the way to "edit" the locked fields of a published form without touching its existing submissions.

readOnlyHint: false · destructiveHint: false

formId string · obrigatório
Form id (GUID).

publish_form

Modifica dados

Publica o rascunho para que possa ser preenchido no link público. Se já estava publicado, as mudanças entram como nova versão e as respostas são mantidas.

Entradas
  • formId

Peça assim Publique o formulário de inscrição e me passe o link.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Publishes the form's current draft so it can be filled out at its public URL. Publishing an already-published form pushes the latest draft changes live as a new version; existing submissions are kept. Unless the form has an enabled email notification, each submission is emailed to the workspace owner.

readOnlyHint: false · destructiveHint: false

formId string · obrigatório
Form id (GUID).

set_pdf_template

Modifica dados

Escolhe o layout de PDF usado ao exportar as respostas do formulário. Uma chave desconhecida devolve a lista das válidas.

Entradas
  • formId
  • key

Peça assim Use o modelo de PDF «classic» no formulário de pedidos.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Sets the PDF layout used when this form's submissions are exported as PDF documents. Pass one of the catalog keys; an unknown key returns the list of valid ones.

readOnlyHint: false · destructiveHint: false · idempotentHint: true

formId string · obrigatório
Form id (GUID).
key string · obrigatório
PDF template key, e.g. "classic".

delete_form

Destrutivo

Manda um formulário para a Lixeira: ele para de aceitar respostas, mas as respostas são mantidas e você pode restaurá-lo pelo aplicativo.

Entradas
  • formId

Peça assim Mande o formulário de teste para a lixeira.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Moves a form to the Trash. The form disappears from lists and its public URL stops accepting responses, but nothing is destroyed: submissions are kept and the owner can restore the form from the Trash in the app. It no longer counts against the workspace's plan form limit while trashed.

readOnlyHint: false · destructiveHint: true

formId string · obrigatório
Form id (GUID).

Modelos

Comece a partir de um modelo da galeria do anota em vez de começar do zero.

list_templates

Somente leitura

Lista os modelos públicos em espanhol, inglês ou português, agrupados por categoria.

Entradas
  • languageopcional

Peça assim Quais modelos de eventos você tem em inglês?

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Lists the ready-made public form templates available in a language ('es' Spanish — the default, 'en' English, 'pt' Portuguese), grouped by category. Each returned id identifies a template that can be copied into the workspace.

readOnlyHint: true

language string · opcional
Template language: 'es' (default), 'en', or 'pt'.

create_form_from_template

Modifica dados

Cria um rascunho no seu espaço de trabalho copiando a estrutura completa de um modelo.

Entradas
  • templateId

Peça assim Crie um formulário a partir do modelo de candidatura de emprego.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Creates a new draft form in the workspace by copying a template's full structure. The draft can then be adjusted and published like any other form.

readOnlyHint: false · destructiveHint: false

templateId string · obrigatório
Template id (GUID).

Lógica condicional

Regras que reagem às respostas. Ficam no rascunho; publique para colocá-las no ar.

add_logic_rules

Modifica dados

Adiciona regras condicionais: mostrar ou ocultar campos, torná-los obrigatórios, pular para uma página, calcular valores, enviar uma cópia por e-mail, mostrar um agradecimento ou redirecionar.

Entradas
  • formId
  • rules

Peça assim Se responderem «Sim» a «Você tem carro?», mostre o campo «Placa».

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Adds conditional logic rules to a form's draft: when a rule's conditions match the respondent's answers, its actions run (show/hide a field, require/unrequire it, enable/disable it, copy another field's value into it, skip to a page, calculate a numeric field from a formula, route a copy of the submission email to an address, show a conditional thank-you message, or redirect to a URL after submit). Rules run in the order given here, after any rules the form already has; a later rule can override an earlier one's show/hide/require/enable/skipToPage/calculate result for the same target. setThankYou/redirectTo are the exception: the FIRST matching rule wins, later matches are ignored. A rule can be added disabled (kept on the form but never evaluated) via 'disabled'. Works on a published form's draft too; new rules go live when the form is published again.

readOnlyHint: false · destructiveHint: false

formId string · obrigatório
Form id (GUID).
rules array · obrigatório
Rules to add, in the order they should run.

edit_logic_rule

Destrutivo

Substitui as condições, as ações e o estado ativo/inativo de uma regra, mantendo o id e a ordem.

Entradas
  • formId
  • ruleId
  • rule

Peça assim Desative a regra que mostra o campo «Placa».

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Replaces an existing logic rule's conditions, actions, and disabled flag, keeping its id and position among the form's rules. Uses the same rule format as adding logic rules.

readOnlyHint: false · destructiveHint: true

formId string · obrigatório
Form id (GUID).
ruleId string · obrigatório
Id of the rule to replace (e.g. "lr_a1b2c3").
rule object · obrigatório
The rule's new definition, replacing the old one entirely.

delete_logic_rule

Destrutivo

Remove uma regra de lógica do rascunho do formulário.

Entradas
  • formId
  • ruleId

Peça assim Apague a regra que redireciona ao enviar o formulário.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Removes a logic rule from a form's draft.

readOnlyHint: false · destructiveHint: true

formId string · obrigatório
Form id (GUID).
ruleId string · obrigatório
Id of the rule to delete (e.g. "lr_a1b2c3").

Respostas

Ler, contar, criar e organizar as respostas dos seus formulários.

list_submissions

Somente leitura

Lista as respostas de um formulário, da mais nova para a mais antiga, com paginação e filtros por status e pagamento.

Entradas
  • formId
  • pageopcional
  • pageSizeopcional
  • statusopcional
  • paymentopcional

Peça assim Mostre as respostas destacadas do formulário de contato.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Lists a form's submissions, newest first, with a short preview of each answer set. Supports paging, an optional status filter and an optional payment filter (by default unpaid Stripe payment submissions are hidden). Each row's id identifies the submission whose full labelled answers can be read.

readOnlyHint: true

formId string · obrigatório
Form id (GUID).
page integer · opcional
1-based page number. Default 1.
pageSize integer · opcional
Rows per page, 1-100. Default 25.
status string · opcional
Optional status filter: New, Read, Flagged, or Spam. Omit for all.
payment string · opcional
Optional payment filter: 'paid' (payment collected) or 'unpaid' (abandoned checkouts, kept 30 days). Omit for the default view, which hides unpaid ones.

get_submission

Somente leitura

Mostra uma resposta completa como pares legíveis de pergunta e resposta.

Entradas
  • submissionId

Peça assim Abra a resposta mais recente do formulário de pedidos.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Gets one submission's full answers as human-readable label/value pairs, resolved against the form version it was submitted to (composite and choice answers are joined into readable strings).

readOnlyHint: true

submissionId string · obrigatório
Submission id (GUID).

submission_stats

Somente leitura

Estatísticas de um formulário: total, contagem por status, respostas por dia nos últimos 7 dias e pagamentos (pagos e não pagos).

Entradas
  • formId

Peça assim Quantas respostas a pesquisa recebeu por dia na última semana?

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Submission statistics for a form: total count, counts per status (New/Read/Flagged/Spam), daily submission counts for the last 7 days (UTC dates, zero-filled), and Stripe payment counts (paid / unpaid). Unpaid payment submissions are excluded from the total, per-status and daily counts.

readOnlyHint: true

formId string · obrigatório
Form id (GUID).

create_submission

Modifica dados

Envia uma resposta a um formulário publicado como se alguém o preenchesse: é validada, respeita os limites do plano e dispara e-mails e webhooks. Em formulários com pagamento devolve um link de pagamento do Stripe, e e-mails e webhooks esperam o pagamento.

Entradas
  • formId
  • answers

Peça assim Crie uma resposta de teste no formulário de pedidos para testar o webhook.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Creates a submission on a published form, as if a respondent had filled it: answers are validated against the live version (required fields, formats; logic-hidden fields are exempt), plan quotas are enforced, and the normal post-submit pipeline (notification emails, webhooks) runs. Keys are the form's field ids; values are strings, or arrays of strings for multi-choice fields.

readOnlyHint: false · destructiveHint: false

formId string · obrigatório
Form id (GUID).
answers object · obrigatório
Answers keyed by field id, e.g. {"f_a1b2c3": "Ana", "f_d4e5f6": ["A","B"]}.

set_submission_status

Modifica dados

Muda o status de uma resposta na caixa de entrada: nova, lida, destacada ou spam. As respostas em si nunca são alteradas.

Entradas
  • submissionId
  • status

Peça assim Marque como spam a última resposta do formulário de contato.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Sets a submission's inbox status: New, Read, Flagged, or Spam. Only the status label changes — the submitted answers are never modified.

readOnlyHint: false · destructiveHint: false · idempotentHint: true

submissionId string · obrigatório
Submission id (GUID).
status string · obrigatório
New status: New, Read, Flagged, or Spam.

delete_submission

Destrutivo

Apaga uma resposta e seus arquivos de forma permanente. Não dá para desfazer.

Entradas
  • submissionId

Peça assim Exclua a resposta de teste que criamos antes.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Permanently deletes a submission and its uploaded files. This cannot be undone — the answers are gone and the storage the files used is released back to the workspace's quota.

readOnlyHint: false · destructiveHint: true

submissionId string · obrigatório
Submission id (GUID).

Notificações por e-mail

Escolha quem recebe um e-mail com cada resposta nova.

set_email_notification

Modifica dados

Envia cada resposta nova por e-mail para até 10 pessoas, sejam ou não membros do seu espaço de trabalho, com o PDF anexado se quiser. Sem notificações, as respostas chegam só ao dono do espaço.

Entradas
  • formId
  • recipients
  • notificationIdopcional
  • enabledopcional
  • subjectopcional
  • attachPdfopcional

Peça assim Sempre que alguém preencher o relatório de máquinas, mande para estes cinco e-mails.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Creates or updates a form's email notification: from then on, every new submission is emailed to the given recipients (any addresses, not only workspace members) as a table of the answers, optionally with the PDF attached. Omit notificationId to add a notification; pass the id of one of the form's existing notifications to replace that one's recipients (and subject/attachPdf when given). Set enabled=false to pause one. By default, with no enabled notification, each submission is emailed to the workspace owner; once an enabled notification exists that default stops, so include the owner in recipients if they should keep receiving submissions.

readOnlyHint: false · destructiveHint: false

formId string · obrigatório
Form id (GUID).
recipients array · obrigatório
Email addresses to notify, one per item, 1-10.
notificationId string · opcional
Id of one of the form's existing email notifications. Omit to create a new one.
enabled boolean · opcional
false pauses the notification without losing its recipients. Default true.
subject string · opcional
Email subject. Omit to keep the current one; empty uses the default "New submission: <form title>" in the form's language.
attachPdf boolean · opcional
Attach the submission's PDF. Omit to keep the current setting (off for a new notification).

Webhooks

Envie cada resposta nova para o seu próprio sistema, assinada para que você possa verificá-la.

list_webhooks

Somente leitura

Lista os webhooks de um formulário: URL, eventos, se está ativo e só uma pista mascarada do segredo (whsec_… e seus últimos 4 caracteres).

Entradas
  • formId

Peça assim Para quais URLs o formulário de pedidos envia as respostas?

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Lists a form's webhooks: id, target URL, subscribed events, enabled flag, and a masked hint of the signing secret (whsec_… plus its last 4 characters). The full secret is returned only once, when the webhook is added; to replace a lost secret, delete the webhook and add it again.

readOnlyHint: true

formId string · obrigatório
Form id (GUID).

add_webhook

Modifica dados

Envia cada resposta nova como JSON para sua URL HTTPS, assinada com o cabeçalho X-Anota-Signature (HMAC-SHA256). O segredo aparece uma única vez, ao ser criado.

Entradas
  • formId
  • url

Peça assim Envie cada resposta do formulário de pedidos para https://meu-app.com/hooks/anota.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Adds a webhook to a form. From then on, every new submission is POSTed as JSON to the given HTTPS URL, with an X-Anota-Signature header (HMAC-SHA256 of the body using the returned secret) so the receiver can verify the payload came from anota. The secret is returned only in this response; listing webhooks shows just a masked hint. Failed deliveries are retried a few times; delivery never blocks or fails the respondent's submission. Payload and signature format: https://docs.p4software.cloud/anota-en/developers-api

readOnlyHint: false · destructiveHint: false

formId string · obrigatório
Form id (GUID).
url string · obrigatório
HTTPS URL to POST each new submission to.

delete_webhook

Destrutivo

Exclui um webhook: as entregas param na hora e o histórico é apagado.

Entradas
  • formId
  • webhookId

Peça assim Remova o webhook de teste do formulário de pedidos.

Detalhes técnicos

Descrição que o modelo recebe (em inglês):

Deletes a webhook from a form. Deliveries stop immediately; past delivery history is removed with it.

readOnlyHint: false · destructiveHint: true

formId string · obrigatório
Form id (GUID).
webhookId string · obrigatório
Webhook id (GUID).

Conecte e experimente

Crie sua chave de API e siga o guia de conexão para o Claude ou o Claude Code.

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.