Neste artigo:
- O que é a integração do Artia com o Gemini?
- O que você precisa antes de começar?
- Quais dados usar na conexão?
- Como conectar o Artia ao Gemini?
- Como usar o Artia no chat do Gemini?
- Como gerenciar a conexão?
- O que fazer se algo der errado?
1. O que é a integração do Artia com o Gemini?
O Artia tem um servidor MCP, uma ponte que permite que assistentes de IA conversem com a sua conta. Quando você adiciona essa ponte ao Gemini como um custom app, pode pedir em linguagem natural coisas como "quais atividades minhas estão atrasadas?" ou "registra 2 horas nesta atividade".
E pode ficar tranquilo quanto à segurança: o Gemini usa as suas permissões. Ele só vê e altera o que você já vê e altera no Artia.
Quer saber sobre integrações com outra IA? Acesse o material MCP do Artia: Integração com Inteligência Artificial
2. O que você precisa antes de começar?
Os custom apps têm algumas exigências do lado do Google. Se alguma delas não for atendida, a opção simplesmente não aparece nas configurações do Gemini. Vale conferir a lista antes, para evitar frustração.
No Google | No Artia |
|---|---|
Conta pessoal (contas de trabalho ou escola não têm custom apps) | Usuário ativo, com e-mail e senha ou login social já configurado |
Plano Google AI Pro ou Ultra | Organização no plano Enterprise. Nas demais, o |
Ter 18 anos ou mais e estar nos Estados Unidos | As permissões são as do seu usuário: o Gemini só |
Gemini com a interface em inglês | |
Gemini Apps Activity ligada | |
Um computador: o cadastro só funciona em gemini.google.com |
Bom saber: em organizações fora do plano Enterprise, o Gemini até conecta, mas as consultas são recusadas.
Dica: o computador só é necessário para o cadastro. Depois de conectado, você também pode usar o Artia no Gemini pelo celular.
3. Quais dados usar na conexão?
Deixe estes dados à mão. Você vai usar no passo 3 da conexão.
Campo | O que preencher | Onde fica no Gemini |
|---|---|---|
MCP server URL |
| Endereço do servidor |
Client ID |
| Em Advanced features |
Client secret | Deixe em branco | Em Advanced features |
Dica: copie e cole os dados em vez de digitar. Um caractere diferente já é suficiente para a conexão falhar.
4. Como conectar o Artia ao Gemini?
Os nomes dos botões aparecem em inglês porque é assim que o Gemini mostra essa área. Siga com calma:
- Abra os apps conectados. Em gemini.google.com, clique em Settings, no canto inferior, e depois em Connected Apps. Não encontrou? Tente Personal Intelligence → Connected Apps.
- Adicione um custom app. Na seção Custom apps, clique em Add a custom app.
- Informe a URL e o Client ID. Cole a URL do servidor. Antes de avançar, clique em Show more, ao lado de Advanced features, e preencha só o Client ID. O Client secret fica vazio.
- Entre no Artia e autorize. Clique em Next. O Gemini abre a tela de login do Artia: entre com seu usuário e autorize o acesso. Depois disso, você volta automaticamente para o Gemini.
- Confira a conexão. Em Connected Apps → Custom apps, o Artia aparece na lista com a chave ligada. Pronto!
Importante: o Artia não faz registro automático de clientes. Por isso o Client ID é obrigatório. Sem ele, o Gemini avisa que o registro falhou e pede as credenciais.
5. Como usar o Artia no chat do Gemini?
É bem simples: digite @ no campo de mensagem e escolha o Artia na lista. Assim, o Gemini sabe que deve usar o Artia para responder aquele pedido.
Primeiro, escolha a organização
No início de cada conversa, o Gemini lista as organizações a que você tem acesso e pede que você escolha uma. Tudo o que vier depois, na mesma conversa, vale para ela. Quer mudar? É só pedir para trocar de organização.
Exemplos para você se inspirar
- @Artia quais atividades minhas estão atrasadas no projeto Implantação ERP?
- @Artia registra 2h30 hoje na atividade "Revisar contrato do cliente", das 9h às 11h30.
- @Artia cria uma atividade "Homologar integração" na pasta Sprint 14, com prazo para sexta.
6. Como gerenciar a conexão?
Você tem total controle sobre a conexão. Tudo fica em Settings → Connected Apps → Custom apps.
Ação | Onde clicar | O que acontece |
|---|---|---|
Desligar | Chave ao lado do Artia | O Artia some do chat, mas continua na lista e conectado. |
Desvincular | More details → Disconnect | Revoga o acesso à sua conta Artia. O app continua na lista e pode ser vinculado de novo. |
Remover | More details → Remove app | Apaga o app do Gemini e desfaz o vínculo com a conta Google. Para voltar, refaça o passo a passo. |
7. O que fazer se algo der errado?
Não se preocupe: a maioria dos problemas tem uma solução rápida. Encontre abaixo o que aparece na sua tela e veja como resolver.
O que aparece | Por que acontece | Como resolver |
|---|---|---|
Não aparece Connected Apps ou Custom apps | Algum requisito da conta Google não foi atendido. | Confira a lista da seção 2: conta pessoal, plano AI Pro ou Ultra, Estados Unidos, interface em inglês e Gemini Apps Activity ligada. |
Automatic registration with this server failed. Please enter the OAuth client ID and client secret. | O Client ID não foi preenchido em Advanced features. | Volte ao passo 3 e informe |
Tela do Artia mostra invalid_client | O Client ID foi digitado errado. | Remova o app e adicione de novo, copiando o Client ID da seção 3. |
Tela do Artia mostra Unregistered redirect_uri | O Client ID é de outra integração (por exemplo, a do Antigravity) ou a URL do servidor está diferente. | Remova o app e adicione de novo com os dados da seção 3. |
Você autorizou no Artia, mas o Gemini não conclui a conexão | Falha conhecida do Gemini com servidores MCP de terceiros: o fluxo para depois de voltar ao Google. | Remova o app (More details → Remove app) e adicione de novo. Se continuar, fale com o suporte do Artia. |
O MCP do Artia é um recurso exclusivo do plano Enterprise… | A organização escolhida não está no plano Enterprise. | Escolha outra organização na conversa ou peça ao administrador para atualizar o plano pelo link da mensagem. |
Organização não encontrada depois de reconectar | A organização escolhida não fica salva entre conexões. | Peça ao Gemini para listar suas organizações e escolha de novo. |
Ainda tem dúvidas? Fale com um de nossos consultores pelo chat em artia.com ou pelo e-mail [email protected].