Tipos de Conectores

Um conector é a conexão entre uma ferramenta de IA externa e o Quiker, feita por meio de um token MCP gerado no seu perfil (veja Conexão via MCP). Atualmente, é possível conectar o Quiker às seguintes ferramentas:

ChatGPT

Aplicativo do ChatGPT para computador

1. Abra o ChatGPT.
2. Acesse Configurações → Servidores MCP.
3. Clique em Adicionar servidor.
4. Preencha:
   • Nome: Quiker;
   • Tipo: Streamable HTTP;
   • URL: https://app.quiker.com.br/api/mcp;
   • Autenticação: Bearer Token;
   • Token: chave de autenticação fornecida pela Quiker.
5. Salve a configuração.
6. Reinicie o aplicativo.
7. Digite /mcp no chat para verificar se o servidor aparece como conectado.

ChatGPT pelo navegador

No ChatGPT web, não é possível cadastrar diretamente uma URL MCP. O servidor precisa estar incluído em um plugin da Quiker. Nesse caso:

1. O usuário acessa a aba Plugins no ChatGPT.
2. Localiza e instala o plugin da Quiker.
3. Realiza a autenticação solicitada.
4. Após a instalação, as ferramentas da Quiker ficam disponíveis nas conversas.
5. Para acessar a ferramenta, basta digitar @ e pesquisar pelo plugin da Quiker.

Claude

1. Acesse o Claude.
2. Entre em Personalizar → Conectores.
3. Clique em Adicionar.
4. Localize o conector Quiker e clique em Conectar.
5. Insira o token do seu perfil.
6. Em uma conversa, clique em + → Conectores e habilite a Quiker.

Ambiente corporativo

Apenas o Owner/Proprietário pode adicionar o conector:

1. Acesse Configurações da organização → Conectores.
2. Clique em Adicionar → Personalizado → Web.
3. Informe a URL do MCP da Quiker.
4. Se necessário, abra Configurações avançadas e informe os dados OAuth.
5. Clique em Adicionar.

Depois disso, cada usuário deverá acessar Personalizar → Conectores, localizar a Quiker e clicar em Conectar.

Copilot (365)

Para permitir a criação, publicação e utilização do Agente Quiker no Microsoft Copilot, o administrador do ambiente deverá liberar as licenças, permissões, créditos, conexões e canais necessários. Depois disso, o usuário responsável pode criar o agente propriamente dito no Copilot Studio.

Os nomes dos menus podem variar de acordo com o idioma e as configurações do ambiente Microsoft.

Configuração do administrador

1. Ativar a licença do Copilot Studio

No Microsoft 365 Admin Center :

1. Acesse Usuários → Usuários ativos.
2. Selecione a pessoa responsável pela criação do agente.
3. Abra Licenças e aplicativos.
4. Ative a licença Copilot Studio User License.
5. Salve as alterações.

2. Conceder acesso ao ambiente

No Power Platform Admin Center :

1. Acesse Gerenciar → Ambientes.
2. Selecione o ambiente em que o agente será criado.
3. Entre em Configurações → Usuários e permissões → Usuários.
4. Selecione o responsável pela criação.
5. Atribua a função Environment Maker.

A função Environment Maker deve ser concedida somente a quem criará ou editará agentes. Usuários que apenas utilizarão o Agente Quiker não precisam dessa permissão.

3. Disponibilizar créditos

No Power Platform Admin Center:

1. Acesse Licenciamento → Produtos → Copilot Studio.
2. Selecione o ambiente.
3. Aloque os Copilot Credits necessários.

Caso não existam créditos disponíveis, será necessário adquirir capacidade adicional ou configurar o modelo pay-as-you-go.

4. Autorizar a conexão com a Quiker

No Power Platform Admin Center:

1. Acesse Políticas → Políticas de dados.
2. Abra a política aplicada ao ambiente.
3. Localize a configuração de Conectores personalizados.
4. Autorize o domínio utilizado na URL do servidor MCP da Quiker. Exemplo: https://app.quiker.com.br/*
5. Classifique o Servidor MCP Quiker como Business/Empresarial.
6. Confirme que o conector não está bloqueado.
7. Salve as alterações.

No endereço, substitua o “app” pelo domínio da sua empresa (ex.: https://empresa.quiker.com.br/).

5. Liberar os canais de acesso

No Power Platform Admin Center:

1. Acesse Segurança → Identidade e acesso → Canais de acesso dos agentes.
2. Selecione o ambiente.
3. Ative os canais que serão utilizados:
   • Microsoft Teams;
   • Microsoft 365 Copilot.
4. Salve as alterações.

6. Configurar a autenticação

No Copilot Studio, acesse Configurações → Segurança → Autenticação e selecione a opção Autenticar com a Microsoft.

Não utilize a opção Sem autenticação, pois o acesso ao agente deve ser identificado e controlado.

Na configuração da ferramenta MCP, escolha como a autenticação com a Quiker será realizada:

• Credenciais do criador: todos os usuários utilizam o token da Quiker configurado pelo criador do agente.
• Credenciais do usuário: cada usuário conecta seu próprio token da Quiker.

Para um piloto controlado, pode ser utilizado o token do criador. Para disponibilizar o agente a um grupo maior, recomenda-se a autenticação individual, garantindo que cada pessoa utilize suas próprias permissões na Quiker.

7. Aprovar e compartilhar o agente

Depois que o criador publicar e enviar o Agente Quiker para aprovação, o administrador deverá:

1. Acessar Microsoft 365 Admin Center → Agentes → Todos os agentes → Solicitações.
2. Localizar e abrir o Agente Quiker.
3. Revisar as ferramentas, conexões e permissões solicitadas.
4. Selecionar Publicar na loja.
5. Definir os usuários ou grupos que poderão acessar o agente.
6. Confirmar a publicação.

Recomenda-se liberar o agente inicialmente para um grupo piloto. Após a validação das conexões, permissões e ações disponíveis, o acesso poderá ser ampliado para outros usuários.

Configuração do usuário

Depois que o administrador libera o ambiente (seção anterior), o usuário responsável pode criar o Agente Quiker:

1. Acesse o Microsoft Copilot Studio.

2. Clique em Criar um agente.

3. Defina o nome, a descrição e as instruções do agente, indicando como ele deverá utilizar as informações e ferramentas da Quiker.

4. Acesse a seção Ferramentas e clique em Adicionar uma ferramenta.

5. Selecione a opção MCP.

6. Clique em Adicionar e selecione novamente a opção MCP, caso seja solicitado.

7. Informe um nome e uma descrição para a conexão MCP.

   Importante: os campos de nome e descrição não podem ter exatamente o mesmo conteúdo.

8. Insira a URL correspondente ao ambiente da empresa: https://empresa.quiker.com.br/

   Substitua “empresa” pelo domínio correto disponibilizado pela Quiker.

9. No método de autenticação, selecione:

   • OAuth;
   • Dinâmico (com descoberta).

10. Conclua a configuração da ferramenta. Quando a página de autorização da Quiker for aberta, informe o token de conexão gerado na plataforma (veja Conexão via MCP).

11. Teste o agente em uma conversa e confirme se:

    • a conexão MCP aparece como ativa;
    • as ferramentas da Quiker estão disponíveis;
    • o agente consegue realizar uma consulta simples;
    • as respostas respeitam as permissões do usuário associado ao token.

12. Após validar o funcionamento, publique o agente e envie-o para aprovação do administrador responsável.

Copilot no VS Code

1. Instale a extensão GitHub Copilot Chat, desenvolvida pela GitHub, e entre com sua conta.
2. Abra a paleta de comandos com Ctrl + Shift + P.
3. Selecione MCP: Add Server → HTTP.
4. Cole a URL do servidor MCP e defina um nome para a conexão.
5. Quando a notificação de autenticação aparecer, clique em Open. Não copie o link para abrir posteriormente.
6. Na página aberta, informe o token de conexão gerado na Quiker (veja Conexão via MCP).
7. Abra o Copilot Chat e faça uma solicitação usando as ferramentas da Quiker para confirmar que a conexão está ativa.

Gemini CLI

O Gemini CLI permite utilizar o Gemini diretamente pelo terminal e conectá-lo às ferramentas da Quiker por meio do MCP. Ele é mais direcionado a desenvolvedores, profissionais de tecnologia e usuários com alguma familiaridade com ferramentas técnicas — sua instalação pode exigir o apoio do time de TI da empresa.

1. Verificar o Node.js

Abra o PowerShell e execute:

node --version

Se aparecer um número de versão, o Node.js está instalado. Se o comando não for reconhecido, será necessário instalar o Node.js antes de continuar.

2. Instalar o Gemini CLI

No PowerShell, execute:

npm install -g @google/gemini-cli

Depois, confirme a instalação:

gemini --version

A instalação foi concluída corretamente se aparecer o número da versão do Gemini CLI.

3. Criar uma pasta para a configuração

Crie uma pasta no computador para armazenar a configuração do Gemini e da Quiker. Escolha um local fácil de encontrar. Copie o caminho da pasta e acesse-a pelo PowerShell:

cd "C:\caminho\da\pasta"

Substitua o exemplo pelo caminho real da pasta.

Atenção: evite executar a configuração dentro de pastas como System32, pois o MCP é adicionado ao projeto correspondente à pasta atual.

4. Criar e configurar a chave do Gemini

Crie uma chave de API no Google AI Studio e copie o valor gerado. No PowerShell, configure a chave com o comando:

$env:GEMINI_API_KEY="SUA_CHAVE_DE_API"

Substitua SUA_CHAVE_DE_API pela chave copiada.

Atenção: a chave é uma credencial confidencial. Não a compartilhe em mensagens, documentos ou capturas de tela.

5. Iniciar e autenticar o Gemini

Execute:

gemini

Caso apareça uma solicitação para confiar na pasta, selecione a opção 3, que nega a confiança.

Na tela de autenticação, serão apresentadas as opções:

1. Sign in with Google;
2. Use Gemini API key;
3. Vertex AI.

Selecione 2 — Use Gemini API key. Como a variável GEMINI_API_KEY já foi configurada, o Gemini utilizará essa chave para concluir a autenticação.

Para sair do Gemini e retornar ao PowerShell, pressione Ctrl + D. Se necessário, pressione duas vezes.

6. Adicionar o MCP da Quiker

Certifique-se de que o PowerShell continua aberto na pasta criada anteriormente. Em seguida, execute:

gemini mcp add --transport http quiker https://app.quiker.com.br/api/mcp

Esse comando adiciona a Quiker como um servidor MCP chamado quiker.

7. Verificar a conexão

Inicie novamente o Gemini:

gemini

Dentro do Gemini CLI, execute:

/mcp

A Quiker deverá aparecer na lista de servidores configurados.

8. Autorizar o acesso à Quiker

Ainda dentro do Gemini CLI, execute:

/mcp auth quiker

Confirme a autenticação com Yes. Uma página será aberta no navegador para concluir a autorização. Na página de autenticação:

1. Acesse a plataforma Quiker;
2. Gere ou copie o token de conexão (veja Conexão via MCP);
3. Informe o token na página de autorização;
4. Conclua o processo.

Depois da autorização, retorne ao Gemini CLI e utilize normalmente os comandos e as ferramentas disponibilizadas pela Quiker.

Possíveis dúvidas e erros

gemini --version

npm install -g @google/gemini-cli

gemini mcp add --transport http quiker https://app.quiker.com.br/api/mcp

gemini mcp list

/mcp auth quiker

$env:GEMINI_API_KEY="SUA_CHAVE_DE_API"

Gemini

O Gemini, do Google, pode ser conectado ao Quiker como um conector MCP nas configurações de ferramentas/extensões do Gemini, informando a URL do endpoint MCP da Quiker e o token gerado em Conexão via MCP.

Nota: o caminho exato de menus e botões pode variar conforme a versão de cada ferramenta.

Nota: Voltar para o índice de Inteligência Artificial.