Documentação

Integração AI MCP

Conecte o Payagenda a app builders como Lovable, Claude e outros com uma chave de API da organização. Um integrador oficial cria a organização e recebe o token; o admin da org também pode gerar tokens em Tokens de API. Sem login no site e sem a chave da RedBase.

Base pública: https://payagenda.com — use só este domínio.

Métodos

Primeiros passos

Há dois tipos de chave. A chave de integrador oficial (pai_) só cria uma organização e devolve o token daquela organização. Depois disso, use somente o token da organização (pa_).

Se você é um integrador oficial, o admin global do Payagenda cadastra o integrador e gera uma chave pai_.
Chame POST /api/v1/organizations com a chave pai_. A resposta traz a organização e um token pa_ de agente administrativo.
Guarde o token pa_ no seu app. A chave pai_ não lista organizações, não lê dados e não gerencia a agenda.
Com o token pa_, configure centros de custo, profissionais, serviços e horários, e então crie agendamentos.
O admin da organização também pode gerar ou revogar tokens em https://payagenda.com/admin/tokens.
MCP: https://payagenda.com/mcp com Authorization: Bearer pa_…. Manifesto: https://payagenda.com/connector/mcp.json.

O administrador da organização gerencia tokens da própria org. Um token da org A nunca lê nem altera a org B.

Uma chave de integrador revogada falha. Usá-la como credencial de gestão também falha.

As mesmas ações existem via HTTP e via ferramentas MCP. O único resource MCP é payagenda://embed (agenda pública da org, não um embed administrativo).

Não envie JWT da RedBase, service role nem cookie de sessão. Essas credenciais não são aceitas na API pública nem no MCP.

Voltar ao início