Fornada
Fornada + assistentes de IA

Pergunte ao ChatGPT ou ao Claude sobre o seu ateliê

O conector do Fornada é um servidor MCP (Model Context Protocol) que deixa assistentes de IA — Claude, ChatGPT, Claude Code e Cursor — consultarem os dados do seu ateliê no Fornada: alunos, turmas, aulas e presenças, peças, fornadas, argila, faturas, despesas e lucro do mês, lista de espera e encomendas. O acesso é somente leitura e exige login com a sua conta do Fornada.

Somente leitura

O assistente consulta os dados do ateliê. Ele não cria, altera nem apaga nada no Fornada.

Entra com a sua conta

Sem chave de API: o assistente abre a tela do Fornada, a dona ou um administrador do ateliê entra e autoriza o acesso.

Revogue quando quiser

Em Configurações → IA, no painel, “Revogar” corta o acesso do assistente na hora.

O que você precisa

  • Uma conta no Fornada como dona ou administrador de um ateliê — qualquer ateliê, sem precisar pedir ativação. Membros da equipe com papel de assistente não conectam. Ainda não usa? Crie sua conta.
  • O ChatGPT ou o Claude — o Fornada está no catálogo oficial dos dois — ou outro assistente que aceite servidores MCP personalizados, como o Claude Code e o Cursor.

Como conectar

ChatGPT

Abrir o Fornada no ChatGPT
  1. Clique no botão acima: a página do Fornada abre no catálogo de plugins do ChatGPT. Clique em Instalar plugin.
  2. Entre com a sua conta do Fornada e, na tela do Fornada, clique em Autorizar.
  3. Numa conversa, chame o Fornada pelo menu + ou digitando @Fornada e faça a sua pergunta.

Claude (web, desktop e celular)

Abrir o Fornada no Claude
  1. Clique no botão acima: a página do Fornada abre no diretório de conectores do Claude. Clique em Conectar.
  2. Entre com a sua conta do Fornada e, na tela do Fornada, clique em Autorizar.
  3. Opcional: na mesma página, desça até Ferramentas, clique em "Suas permissões de ferramentas" e troque "Requer aprovação" / "Personalizado" por "Sempre permitir" — assim o Claude consulta sem pedir confirmação a cada pergunta.
  4. Numa conversa nova, pergunte, por exemplo: "como está o ateliê hoje?"

Claude Code

  1. No terminal, rode:
    claude mcp add --transport http fornada https://api.fornada.app/mcp
  2. Dentro do Claude Code, digite /mcp, escolha fornada e autorize o acesso no navegador.

Cursor

  1. Abra Cursor Settings → MCP e clique em Add new MCP server — ou edite o arquivo mcp.json:
  2. {
      "mcpServers": {
        "fornada": {
          "url": "https://api.fornada.app/mcp"
        }
      }
    }
  3. Salve. Quando o Cursor pedir login para o servidor fornada, entre e autorize o acesso na janela do Fornada.

Endereço do servidor

Para o Claude Code, o Cursor e outros assistentes compatíveis com MCP — no ChatGPT e no Claude, use os botões acima:

https://api.fornada.app/mcp

Autenticação: OAuth 2.1 com registro dinâmico de cliente. O assistente descobre sozinho onde fazer o login; não há chave de API para copiar.

Exemplos de perguntas

  • Quem tem aula hoje e quais chamadas ainda faltam?
  • Quais alunos estão com fatura vencida este mês?
  • Quantas peças estão na fila do esmalte e de quem são?
  • Quanto recebi de mensalidades em agosto comparado com julho?
  • Quais alunos retiraram mais argila nos últimos 3 meses?
  • Qual turma tem vaga na terça à noite?
  • Qual foi o lucro de setembro?

O que o assistente consegue consultar

O conector oferece 19 ferramentas, todas somente leitura. O assistente escolhe qual usar a partir da sua pergunta.

get_studioIdentifica o ateliê: nome, fuso horário, data de hoje, seu papel e a equipe.
get_dashboardOs números do painel inicial: aulas de hoje, chamadas pendentes, faturas em aberto, recebido no mês.
search_studentsBusca alunos, inativos e interessados por nome, e-mail ou telefone.
get_studentA ficha de um aluno: contato, matrículas, presenças, reposições, peças, argila e faturas.
list_classesTurmas com horário, vagas, ocupação e preço, e a grade semanal.
get_classUma turma com os alunos matriculados, pendentes e na lista de espera.
list_sessionsAulas entre duas datas, com presença registrada e chamadas pendentes.
list_waitlistInteressados aguardando vaga, com a disponibilidade de horário.
list_piecesPeças por etapa (aguardando queima, na queima, prontas, retiradas) ou por pagamento das queimas.
list_firingsFornadas (queimas) com etapa, forno, tipo e datas.
get_firingUma fornada com cada peça, o dono e o valor cobrado.
list_clay_pickupsRetiradas de argila num período ou de um aluno, com totais.
list_invoicesFaturas por status, aluno ou mês, com emitido, recebido e em aberto.
get_invoiceUma fatura com as linhas cobradas e os pagamentos registrados.
list_ordersEncomendas de peças com cliente, etapa, preço e prazo (ateliês com encomendas ativadas).
get_finance_summaryO Financeiro do mês: receitas (faturas pagas e outras receitas), despesas por categoria, lucro e margem, e os últimos 12 meses.
list_financial_entriesDespesas e outras receitas lançadas no Financeiro num mês ou período, com totais.
describe_dataO dicionário de dados que a consulta livre aceita.
query_dataConsulta livre (SQL somente leitura) sobre os dados do ateliê, para perguntas que as outras ferramentas não cobrem.

Privacidade e segurança

  • Cada conexão enxerga apenas os dados do ateliê de quem a autorizou.
  • CPF e CNPJ, dados dos provedores de pagamento, chaves de acesso, senhas e fotos nunca saem pelo conector.
  • As respostas vão para o assistente que você escolheu, dentro da sua conta nele, e seguem a política de privacidade desse provedor. O Fornada não recebe as suas conversas.
  • Para revogar: Configurações → IA → Suas conexões, no painel, ou remova o conector no próprio assistente.

Os detalhes estão na Política de Privacidade, seção 6.

Suporte

Dúvidas ou problemas para conectar? Escreva para oi@fornada.app.

In English

Fornada connector for ChatGPT, Claude and other MCP clients

Fornada is a management system for pottery studios in Brazil. Its remote MCP server lets AI assistants answer questions about a studio's students, classes, attendance, pieces, kiln firings, clay pickups, invoices, monthly expenses and profit, waitlist and orders.

  • Listed in the ChatGPT plugin directory and the Claude connector directory. Server URL for other clients: https://api.fornada.app/mcp (Streamable HTTP).
  • Authentication: OAuth 2.1 with dynamic client registration; users sign in with their Fornada account and approve access on a consent screen. No API keys. Only a studio's owner and admins can connect; assistant-role members are refused.
  • Read-only: all 19 tools are annotated readOnlyHint: true and never modify data. Tax IDs, payment-provider data, credentials and photos are never returned.
  • Available to every Fornada studio; nothing is shared until an owner or admin connects an assistant, and they can revoke it anytime under Settings → IA.
  • Tool descriptions and messages are in Brazilian Portuguese. Support: oi@fornada.app · Privacy policy · Terms.