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, 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, você entra e autoriza o acesso.

Revogue quando quiser

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

Endereço do servidor

Cole este endereço no seu assistente — é o mesmo para todos os ateliês:

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.

O que você precisa

Uma conta no Fornada, com acesso a um ateliê. Ainda não usa? Crie sua conta.
O acesso por assistentes ativado no seu ateliê. Ele fica desligado por padrão: fale com a gente em oi@fornada.app ou pelo WhatsApp para ativar. Depois disso, o passo a passo também aparece no painel, em Configurações → IA.
Um assistente que aceite conectores MCP personalizados (veja abaixo).

Como conectar

Claude (web, desktop e celular)

No Claude, abra Configurações → Conectores e clique em Adicionar conector personalizado.
Dê o nome Fornada e cole o endereço do servidor.
Clique em Conectar: uma janela do Fornada pede para você entrar e autorizar o acesso.
Numa conversa nova, ative o conector Fornada e pergunte, por exemplo: “como está o ateliê hoje?”.

ChatGPT

No ChatGPT, vá em Configurações → Plugins → Modo de desenvolvedor e ative o Modo desenvolvedor.
Em Plugins, clique no +, dê o nome Fornada, cole o endereço do servidor no campo Conexão e escolha autenticação OAuth.
Autorize o uso de servidores MCP personalizados.
Clique em Criar e autorize o acesso na janela do Fornada.
Numa conversa, adicione o conector Fornada pelo menu + e faça a sua pergunta.

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.

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?

O que o assistente consegue consultar

O conector oferece 17 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.

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).

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, waitlist and orders.

Server URL: 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.
Read-only: all 17 tools are annotated readOnlyHint: true and never modify data. Tax IDs, payment-provider data, credentials and photos are never returned.
Access is off by default and enabled per studio; users revoke it anytime under Settings → IA.
Tool descriptions and messages are in Brazilian Portuguese. Support: oi@fornada.app · Privacy policy · Terms.