Chaves de API de IA

Chave de API do Claude

A UNIA conversa usando a IA da sua própria empresa. Se a escolha for o Claude, da Anthropic, a chave é criada no Claude Console. Não confunda com o token de usuário, que vai na tela Conectar à UNIA.

Link para copiar

Vídeo 0:17

Passo a passo

1. Abra o Claude Console

   Entre em platform.claude.com com a sua conta.

2. Vá em Chaves de API

   No menu lateral, clique em Chaves de API e depois em Criar chave.

3. Dê um nome

   Mantenha o espaço de trabalho Default, escreva um nome (ex.: UNIA API) e clique em Adicionar.

4. Copie a chave

   Em Salve sua chave de API, clique em Copiar chave e depois em Concluído. A chave começa com sk-ant- e não aparece de novo.

Chaves de API de IA

Chave de API da OpenAI

A UNIA conversa usando a IA da sua própria empresa. Se a escolha for o GPT, da OpenAI, a chave é criada na plataforma da OpenAI. Não confunda com o token de usuário, que vai na tela Conectar à UNIA.

Link para copiar

Vídeo 0:19

Passo a passo

1. Abra a plataforma

   Entre em platform.openai.com com a sua conta.

2. Vá em API keys

   No menu lateral, clique em API Keys e depois em Create new secret key.

3. Preencha

   Em Name, escreva um nome (ex.: UNIA API). Mantenha Owned by You, Project Default project e Permissions All. Clique em Create secret key.

4. Copie a chave

   Em Save your key, clique em Copy e depois em Done. A chave começa com sk-proj- e não aparece de novo.

Chaves de API de IA

Chave de API do Gemini

A UNIA conversa usando a IA da sua própria empresa. Se a escolha for o Gemini, do Google, a chave é criada no Google AI Studio. Não confunda com o token de usuário, que vai na tela Conectar à UNIA.

Link para copiar

Vídeo 0:13

Passo a passo

1. Abra o Google AI Studio

   Entre em aistudio.google.com com a sua conta Google.

2. Vá em Chaves de API

   Clique em Dashboard → Chaves de API e depois em Criar chave de API.

3. Preencha

   Dê um nome à chave (ex.: UNIA API), escolha o projeto e clique em Criar chave.

4. Copie a chave

   Em Detalhes da chave de API, clique em Copiar chave.

Primeiros passos

Conecte a UNIA ao seu assistente de IA

O MCP da UNIA liga o Claude, o ChatGPT, o Claude Code, o Codex, o Lovable, o Antigravity e outros clientes compatíveis com MCP aos dados do seu UNO ERP. A configuração é a mesma em todos: um link e o seu token de usuário.

Como funciona

1. Gere o token de usuário

   No UNO ERP, em Meus Dados, gere e copie o token do campo Chave API.

2. Adicione o link

   No cliente de IA, cadastre a UNIA como servidor MCP usando o seu link.

3. Cole o token de usuário

   O cliente abre a tela Conectar à UNIA. Cole o token e pronto.

Seu link

O endereço é o mesmo para todos os clientes. Troque <SUA_APLICAÇÃO> pelo nome da aplicação da sua empresa no UNO ERP, com a primeira letra maiúscula (ex.: Uno). Digite o nome no campo abaixo, sem se preocupar com maiúsculas, e os links desta documentação saem prontos.

O Antigravity é a exceção: lá o link vai dentro de um JSON, que está pronto na página dele.

Escolha o cliente

Chave de API da IA

A UNIA conversa usando a IA da sua própria empresa, com a chave de API do provedor que vocês escolherem. O uso é cobrado pelo provedor, na conta em que a chave foi criada. Essa chave não é o token de usuário: ela não vai na tela Conectar à UNIA.

Antes de começar

• Acesso ao UNO ERP com o seu usuário, para gerar o token de usuário em Meus Dados.
• O nome da aplicação da sua empresa (é o <SUA_APLICAÇÃO> do link).
• Um cliente com suporte a servidor MCP remoto. Os seis desta documentação têm passo a passo, e cinco deles também têm vídeo.

Primeiros passos

Obter o token de usuário

O token de usuário é a sua chave pessoal de acesso ao UNO ERP: é ele que identifica você na UNIA. Todo cliente de IA pede esse token na tela Conectar à UNIA, então gere e copie antes de configurar qualquer um deles.

Qual token é este

Esta documentação fala de três coisas parecidas. Só a primeira é gerada nesta página.

Nos outros tutoriais, sempre que o passo for Cole o token de usuário, é o token desta página.

Link para copiar

Você vai usar este link no próximo passo, no cliente que escolher.

Vídeo 0:12

Passo a passo

1. Abra Meus Dados

   No UNO ERP, clique no seu usuário, no canto superior direito, e escolha Meus Dados.

2. Gere o token de usuário

   No campo Chave API, clique em Gerar token API para integração e confirme com Sim.

3. Copie

   Clique no ícone de copiar ao lado do campo. A mensagem Token copiado com sucesso confirma.

Assistentes de IA

Claude

Adicione a UNIA como conector personalizado e pergunte sobre os dados da empresa direto na conversa. Funciona no app do Claude e no claude.ai.

Dados para copiar

Vídeo 0:45

Passo a passo

1. Abra os conectores

   Na caixa de mensagem, clique em + → Adicionar conector → Adicionar conector personalizado.

2. Preencha

   Em Nome, coloque UNIA. Em URL do servidor MCP, cole o link acima. Clique em Continuar.

3. Confirme a autenticação

   Mantenha as opções que o Claude detecta (Entrar agora e Registrar automaticamente) e conclua.

4. Cole o token de usuário

   Na tela Conectar à UNIA, que abre no navegador, cole o token de usuário e clique em Conectar.

5. Ative na conversa

   Quando aparecer Conectado a UNIA, ligue o conector em + → Conectores → UNIA.

Assistentes de IA

ChatGPT

Adicione a UNIA como plugin no ChatGPT e pergunte sobre os dados da empresa direto na conversa. O plugin é criado no modo desenvolvedor, pela versão web.

Dados para copiar

Passo a passo

1. Ative o modo desenvolvedor

   No ChatGPT pela web, abra Configurações → Segurança e login e ligue o Modo desenvolvedor. Em algumas contas essa opção fica em Aplicativos → Configurações avançadas.

2. Crie o plugin

   Abra Plugins (ou Aplicativos, conforme a conta) e clique em + para criar um novo.

3. Preencha

   Coloque o nome e a descrição acima. Em Conexão, escolha o endpoint público e cole o link. Se aparecer o tipo de autenticação, escolha OAuth. Se o ChatGPT avisar que o servidor não é verificado pela OpenAI, confirme que confia nele. Depois, crie o plugin.

4. Cole o token de usuário

   Na hora de conectar, o ChatGPT abre a tela Conectar à UNIA. Cole o token de usuário e clique em Conectar.

5. Use na conversa

   Abra uma conversa nova e adicione a UNIA pelo menu de ferramentas (+) da caixa de mensagem.

Editores de código

Claude Code no VS Code

Cadastre a UNIA como servidor MCP na extensão do Claude Code para consultar tabelas, regras de negócio e dados do ERP enquanto programa.

Dados para copiar

Vídeo 1:01

Passo a passo

1. Abra os servidores MCP

   No painel do Claude Code, clique no ícone / da caixa de mensagem e escolha MCP servers, na seção Customize. Depois clique em Add server.

2. Preencha

   Name UNIA, Transport HTTP (remote), URL com o link acima e Scope User. Clique em Add server.

3. Autentique

   Abra de novo / → MCP servers, clique em UNIA (marcado Needs Auth) e em Authenticate.

4. Cole o token de usuário

   Se o VS Code perguntar se pode abrir o site externo, clique em Abrir. No navegador, cole o token de usuário na tela Conectar à UNIA e clique em Conectar. A página Authentication successful confirma; pode voltar ao VS Code.

Editores de código

Codex no VS Code

Cadastre a UNIA como servidor MCP na extensão do Codex, da OpenAI, para consultar tabelas, regras de negócio e dados do ERP enquanto programa.

Dados para copiar

Vídeo 0:36

Passo a passo

1. Abra as configurações

   No painel do Codex, clique na engrenagem (Configurações), ao lado de Chats.

2. Adicione o servidor

   Vá em Servidores MCP e clique em Adicionar servidor.

3. Preencha

   Nome UNIA, Tipo HTTP com streaming e URL com o link acima. Deixe o resto em branco e clique em Salvar.

4. Autentique

   Na lista de servidores, clique em Autenticar ao lado da UNIA. Se o VS Code perguntar se pode abrir o site externo, clique em Abrir.

5. Cole o token de usuário

   No navegador, cole o token de usuário na tela Conectar à UNIA e clique em Conectar. Quando aparecer Authentication complete, volte ao VS Code: a UNIA fica ativa na lista.

Editores de código

Antigravity

No Antigravity, a UNIA entra pelo arquivo mcp_config.json. Depois você autentica pelo painel de servidores MCP.

Dados para copiar

{
    "mcpServers": {
        "unia-erp": {
            "serverUrl": "https://unia-mcp.unoerp.com.br/<SUA_APLICAÇÃO>"
        }
    }
}

Se o arquivo já tiver outros servidores, acrescente só o bloco "unia-erp" dentro de "mcpServers".

Vídeo 0:51

Passo a passo

1. Abra a configuração

   No painel Agent, clique em ⋯ → MCP Servers → Manage MCP Servers → View raw config.

2. Cole o JSON

   Cole o conteúdo acima no mcp_config.json e salve.

3. Atualize e autentique

   Volte para Manage MCP servers, clique em Refresh e, no unia-erp, em Authenticate.

4. Cole o token de usuário

   No navegador, cole o token de usuário na tela Conectar à UNIA e clique em Conectar. A página do Google Antigravity mostra um código: clique em Copy to Clipboard.

5. Envie o código

   Em Settings → Customizations → Installed MCP Servers, cole o código no campo do unia-erp e clique em Submit. Com o status verde, aparece 6 tools enabled.

Criadores de apps

Lovable

Conecte a UNIA ao Lovable para que o agente monte telas e apps com as tabelas, as regras de negócio e os dados reais do seu ERP.

Dados para copiar

Vídeo 0:46

Passo a passo

1. Abra os conectores

   Na caixa do prompt, clique em + → Add context → Connectors.

2. Crie o servidor

   Busque por mcp e escolha New MCP server.

3. Preencha

   Server name UNIA, Server URL com o link acima e Authentication OAuth (default). Clique em Add & authorize.

4. Cole o token de usuário

   Na janela Conectar à UNIA, cole o token de usuário e clique em Conectar.

5. Pronto

   Com MCP server added successfully, o Lovable lista as ferramentas da UNIA e a permissão de cada uma.

UNO ERP

Aplicações da UNIA no UNO ERP

Toda aplicação criada com a UNIA, como um painel feito no Lovable, pode virar uma tela do UNO ERP, com menu próprio e permissão por grupo. O vídeo usa esta documentação como exemplo de aplicação.

Dados para copiar

Vídeo 1:15

Passo a passo

1. Abra o cadastro de menus

   Em Cadastros Gerais → Cadastros Iniciais, na seção Customização, clique em Menu.

2. Crie o menu

   Clique em +. Em Cadastro Menu Personalizado, preencha Nome, Sistema e, em Comando, o endereço da sua aplicação. Em Parâmetros, escolha {TOKEN}. Clique em Gravar: o ERP gera o código do programa (no vídeo, GGC10115).

3. Libere a permissão

   Em Segurança → Permissões, abra o grupo que vai usar a tela (ex.: Administrador). Em Disponíveis, passe o programa criado para Selecionados e clique em Gravar.

4. Entre de novo

   Saia do ERP pelo menu do usuário (Sair) e entre de novo para carregar a permissão.

5. Abra a tela

   No módulo escolhido em Sistema (no vídeo, Gerência Geral), clique no menu criado. A aplicação abre dentro do ERP.

UNO ERP

Usuário e permissão na sua aplicação

Para quem constrói a aplicação: como ler o token que o UNO ERP envia pelo parâmetro {TOKEN}, validar o usuário e conferir se ele tem permissão para a tela. Baixe o manual e envie para a IA que está construindo a aplicação, como o Lovable, o Claude Code ou o Codex.

Enviar para a IA

Troque <CÓDIGO_DO_PROGRAMA> pelo código que o ERP gerou ao gravar o menu (no vídeo, GGC10115).

Referência

Ferramentas do MCP

Depois de conectado, o cliente passa a enxergar estas ferramentas. Você não precisa chamá-las pelo nome: basta perguntar em linguagem natural, e o assistente escolhe qual usar.

Lista

Referência

Solução de problemas

As mensagens mais comuns na hora de conectar e o que fazer em cada caso.

Mensagens de erro

Por cliente