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.
O assistente consulta os dados do ateliê. Ele não cria, altera nem apaga nada no Fornada.
Sem chave de API: o assistente abre a tela do Fornada, a dona ou um administrador do ateliê entra e autoriza o acesso.
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- Clique no botão acima: a página do Fornada abre no catálogo de plugins do ChatGPT. Clique em Instalar plugin.
- Entre com a sua conta do Fornada e, na tela do Fornada, clique em Autorizar.
- 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- Clique no botão acima: a página do Fornada abre no diretório de conectores do Claude. Clique em Conectar.
- Entre com a sua conta do Fornada e, na tela do Fornada, clique em Autorizar.
- 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.
- Numa conversa nova, pergunte, por exemplo: "como está o ateliê hoje?"
Claude Code
- No terminal, rode:
claude mcp add --transport http fornada https://api.fornada.app/mcp
- Dentro do Claude Code, digite
/mcp, escolha fornada e autorize o acesso no navegador.
Cursor
- Abra Cursor Settings → MCP e clique em Add new MCP server — ou edite o arquivo mcp.json:
{ "mcpServers": { "fornada": { "url": "https://api.fornada.app/mcp" } } }- 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.
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: trueand 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.

