Como conectar os dados da fazenda ao ChatGPT e ao Claude

Para conectar os dados da fazenda ao ChatGPT ou ao Claude, você adiciona um conector no assistente — uma ponte que permite a ele consultar o seu sistema de gestão na hora da pergunta — e entra com a sua própria conta do portal. Na upCampo, o endereço é sempre o mesmo para os dois: https://mcp.upcampo.com.br/mcp. Depois de autorizado, o assistente deixa de responder com informação genérica da internet e passa a responder com os números da sua safra, respeitando exatamente as permissões que o seu usuário já tem, fazenda por fazenda. Este guia explica o que muda na prática, o que dá para perguntar, o que dá para registrar e como fazer a conexão nos dois lados — inclusive uma armadilha de configuração que já derrubou a conexão de dois usuários.

O que é um conector, em linguagem de fazenda

Um assistente de IA, sozinho, sabe muito sobre agricultura e nada sobre a sua agricultura. Pergunte quanto choveu no talhão 12 em agosto e ele dirá que não tem acesso a isso — ou, pior, vai estimar. O conector resolve esse buraco: é um endereço cadastrado uma vez no assistente que, dali em diante, permite a ele buscar o dado na fonte no momento da pergunta.

O padrão por trás disso se chama MCP, e é aberto. Não é uma integração exclusiva com um aplicativo: é a mesma tomada que Claude e ChatGPT adotaram para se ligar a sistemas externos, e é por isso que o endereço da upCampo é um só e serve para os dois. O que importa para quem está na fazenda é a consequência: não há exportação, não há planilha intermediária, não há cópia de dado em lugar nenhum. Cada pergunta é uma consulta feita na hora, contra o sistema, com o seu login.

O que muda quando a IA enxerga os dados reais

A diferença fica evidente na primeira pergunta. Sem conector, “qual o meu custo por hectare está alto?” devolve uma aula sobre composição de custo agrícola. Com conector, devolve a lista dos seus talhões, com o valor de cada um, na safra corrente.

Três mudanças práticas aparecem logo:

• A pergunta substitui o relatório. Boa parte do que se pede ao escritório é uma consulta pontual — quanto sobrou daquele produto, quais ordens estão abertas, quanto já foi colhido no setor. Vira uma frase, sem filtro para escolher e sem esperar alguém gerar.
• O cruzamento fica barato. “Compare a chuva dos últimos 30 dias com o andamento do plantio por talhão” exigiria duas telas e uma planilha no meio. Para o assistente, é uma pergunta só.
• Quem não usa o sistema volta a enxergar a fazenda. O sócio, o consultor externo, a controladoria: pessoas que não vão aprender a navegar o portal, mas que já conversam com uma IA todo dia. É aí que o conector rende mais.

O limite é o mesmo do WhatsApp: os números vêm do seu sistema, mas quem monta a frase é o assistente. Para fechamento de safra, conferência de estoque e custo final, o relatório oficial do portal continua sendo o documento. O conector serve para consultar rápido e decidir mais cedo, não para substituir o fechamento.

O que dá para perguntar

São doze ferramentas de consulta, cobrindo os assuntos do dia a dia. Na prática você não escolhe ferramenta nenhuma: escreve a pergunta com as suas palavras e o assistente decide onde buscar.

Assunto	Exemplo de pergunta
Fazendas e safras	Quais fazendas e safras eu tenho acesso?
Produção	Qual foi a produtividade média por hectare de cada variedade de soja?
Chuva e clima	Quanto choveu em cada talhão nos últimos 30 dias?
Monitoramento de pragas	Quais pragas apareceram acima do nível de controle no último levantamento?
Ordens de serviço	Quais ordens agrícolas ainda não foram finalizadas e qual a área de cada uma?
Estoque	Quais defensivos estão com saldo abaixo do estoque mínimo?
Frota	Qual foi o consumo médio dos tratores no mês passado?
Pós-colheita	Quantos fardos foram colhidos nesta safra e qual o rendimento médio?
Custos	Qual o custo por hectare de cada talhão nesta safra?

Duas das doze não consultam a fazenda: buscam e leem os artigos da Central de Ajuda. “Como eu cadastro um talhão novo?” também tem resposta — e essa não depende de permissão, porque a documentação é pública. Se você tem mais de uma fazenda, o assistente responde pela sua fazenda corrente; para perguntar de outra, basta citá-la na frase.

Cada assunto tem um método por trás, e vale conhecê-lo para interpretar o que volta: o monitoramento de pragas depende do nível de controle que a fazenda cadastrou, o custo por talhão depende do rateio das ordens de serviço, e o estoque depende da entrada da nota e da baixa pela aplicação. O assistente lê o que está lá; não conserta cadastro incompleto.

O que dá para registrar por ali

Além das doze consultas, há cinco ferramentas de lançamento: chuva, abastecimento, execução de ordem de serviço, ordem de serviço e entrada de nota. São os mesmos registros que a UPí já faz pelo WhatsApp, agora disponíveis no assistente que você usa no computador.

Duas regras valem para todos: o assistente resume o que vai ser lançado e espera a sua confirmação, e lançar depende de uma permissão própria, separada da de consulta e liberada por fazenda. Faltando a permissão, ele avisa qual é e não grava.

E há uma ausência deliberada: nenhuma das dezessete ferramentas apaga dados. Não existe função de exclusão no conector. O pior cenário de um erro é um lançamento a mais, que se corrige no portal — nunca um registro perdido.

Antes de conectar: três pré-requisitos

Confirme as três condições antes de abrir as configurações do assistente. A terceira é a que costuma faltar.

1. A UPí contratada. O conector faz parte dela, e ela é contratada à parte dos demais módulos. As condições estão em preços.
2. Conta ativa no portal upCampo, com o e-mail (ou login) e a senha que você já usa.
3. As permissões de consulta liberadas pelo administrador da sua empresa. No controle de acesso do portal, são as que começam com “Consulta do tema”, e elas valem por fazenda: dá para liberar lavoura numa e estoque em outra. O detalhe de onde marcar está no artigo da tela de Usuários.

Se o login funcionar e mesmo assim aparecer “acesso ainda não liberado”, é a terceira condição que falta: usuário e senha estão certos, falta a permissão. Refazer a conexão não resolve — o caminho é pedir ao administrador.

Passo a passo no Claude

São cinco passos, e o mais demorado é digitar a senha.

1. Abra as Configurações e vá em Conectores.
2. Clique em Adicionar e escolha adicionar um conector personalizado.
3. Informe o endereço https://mcp.upcampo.com.br/mcp e confirme.
4. A tela de login da upCampo abre. Entre com o seu e-mail (ou login) e a sua senha, e autorize o acesso.
5. Comece uma conversa nova e pergunte sobre a fazenda.

A armadilha: os campos de OAuth avançado ficam em branco

Na hora de informar o endereço, o Claude oferece configurações avançadas, com dois campos: “ID do cliente OAuth” e “Segredo do cliente OAuth”. A tentação é natural — parecem os campos de usuário e senha.

Não são. Eles têm de ficar em branco.

Quem os preenche com o login e a senha do portal faz a conexão falhar antes mesmo de a tela de login aparecer. Já aconteceu com dois usuários, e o sintoma engana: parece problema de senha, quando é o contrário — a senha está certa, digitada no lugar errado. Esses campos existem para quem opera o próprio servidor de autenticação; no conector da upCampo o cadastro é automático. Se a conexão já falhou, apague o conector, adicione de novo e deixe os dois campos vazios.

Passo a passo no ChatGPT

No ChatGPT o recurso aparece como plugin e exige plano Business, Enterprise ou Edu, pelo navegador. Essa exigência é do assistente, não da upCampo.

1. Nas configurações, abra Plugins e ative o modo desenvolvedor (nos planos Business, isso é feito por um administrador, nas configurações do workspace).
2. Clique em Create e informe o endereço https://mcp.upcampo.com.br/mcp.
3. Escolha OAuth como autenticação e clique em Scan Tools.
4. Entre com a sua conta upCampo na tela que abrir e conclua a criação.

Um detalhe de organização: o plugin nasce como rascunho, visível só para quem criou, e só o administrador do workspace o publica para a equipe. Vale combinar isso antes, ou a controladoria vai perguntar por que só uma pessoa consegue usar.

O passo a passo detalhado está na página do conector na Central de Ajuda; o resumo, na página do conector no site.

Como ficam a permissão e o registro de acesso

Esta é a parte que a área de tecnologia do cliente pergunta primeiro, e a resposta é curta: o conector não cria acesso novo. Ele reaproveita, tal e qual, o que o seu usuário já tem no portal.

• A senha não fica com o assistente. Você a digita numa tela da própria upCampo; o assistente recebe apenas uma autorização, revogável a qualquer momento pela tela de conectores dele. Revogou, o acesso encerra na hora.
• Fazenda por fazenda, assunto por assunto. Se o seu usuário enxerga duas das cinco fazendas do grupo, o assistente enxerga as mesmas duas. Se você tem consulta de estoque mas não de custo, a pergunta de custo não é respondida — e ele diz qual permissão falta, em vez de inventar.
• Nada é copiado. Cada pergunta gera uma consulta na hora; o conector não mantém base paralela com os seus dados agrícolas.
• Todo uso fica registrado, como o acesso ao portal. É o mesmo registro de acessos que a fazenda exporta quando precisa auditar quem viu o quê. Os critérios gerais estão no artigo de segurança da informação.

Na prática, liberar o conector para alguém não é uma decisão de TI diferente das que a fazenda já toma: é a mesma decisão de sempre — o que essa pessoa pode ver —, tomada na mesma tela de sempre.

Por onde começar

Comece pela pergunta que você faz toda semana para outra pessoa: quanto choveu, quanto falta colher, o que sobrou no estoque, quais ordens estão abertas. Conecte, faça essa pergunta e confira a resposta contra o relatório uma vez. O caminho contrário — pedir uma análise grande logo no primeiro dia — costuma frustrar, porque a resposta depende de um cadastro que talvez ainda não esteja completo. A IA enxerga exatamente o que a operação registrou; é o velho problema da gestão agrícola, agora com um interlocutor que responde na hora.

Perguntas frequentes

O que é um conector de IA?

É uma ponte entre um assistente de IA e um sistema externo. Cadastrada uma vez, permite ao assistente consultar os dados na fonte no momento da pergunta, em vez de responder de forma genérica. O padrão é o MCP, aberto e adotado por Claude e ChatGPT.

Qual é o endereço do conector da upCampo?

https://mcp.upcampo.com.br/mcp. O mesmo endereço serve para o Claude e para o ChatGPT.

Preciso de uma chave de API para conectar?

Não. A autenticação é por OAuth: a tela de login é da própria upCampo e pede a mesma credencial do portal. Não existe chave de API para o usuário final.

Nas configurações avançadas do Claude, o que coloco em “ID do cliente OAuth” e “Segredo do cliente OAuth”?

Nada — os dois campos ficam em branco. Preenchê-los com o login e a senha do portal faz a conexão falhar antes mesmo de a tela de login abrir. A senha só é digitada na tela da upCampo que abre depois.

O conector pode alterar ou apagar dados do meu sistema?

Alterar, dentro de um limite: cinco lançamentos — chuva, abastecimento, execução de ordem de serviço, ordem de serviço e entrada de nota —, sempre com a sua confirmação e só com a permissão correspondente. Apagar, não: nenhuma ferramenta exclui informação.

Quais dados o assistente enxerga da minha fazenda?

Apenas os das fazendas às quais o seu usuário já tem acesso no portal, e apenas dos assuntos liberados para ele no controle de acesso. O conector não amplia permissão: reaproveita a que existe.

Apareceu “acesso ainda não liberado” depois do login. O que fazer?

O login funcionou, mas falta permissão de consulta. Peça ao administrador da sua empresa para marcar, no controle de acesso do portal, as permissões que começam com “Consulta do tema”. Elas são liberadas por fazenda.

Funciona em qualquer plano do Claude e do ChatGPT?

No Claude, conectores personalizados estão disponíveis nos planos pagos. No ChatGPT, o recurso exige plano Business, Enterprise ou Edu e funciona pelo navegador. Nos dois casos, a exigência é do assistente de IA, não da upCampo.