Conectar um assistente de IA pelo MCP

O que funciona hoje

O servidor aceita chave de API, no cabeçalho Authorization. A conexão por OAuth, em que você cola o endereço e aprova numa tela do G3 Apply sem copiar segredo, está em teste: conferimos com um cliente MCP local, ainda não com o ChatGPT, o Claude ou o Cursor. Por enquanto, os passos abaixo usam chave.

Não confunda com o /mcp público do site: ele só responde sobre o produto, não acessa conta e não pede chave.

Antes de começar: gere uma chave

Todo cliente usa este endereço e a chave que você gerar:

https://apply.g3infotech.app/api/mcp

1. Entre no G3 Apply e abra a seção Integrações da sua conta.
2. Clique em Gerar chave, dê um nome e marque só o que o assistente precisa. O padrão é só ler copilots.
3. Escolha a validade e copie a chave, que aparece uma única vez. Trate como uma senha.

Claude Code

No terminal, troque SUA_CHAVE pela sua chave e rode:

claude mcp add --transport http g3apply https://apply.g3infotech.app/api/mcp \
  --header "Authorization: Bearer SUA_CHAVE"

Confira com claude mcp list: o servidor aparece como Connected. A chave fica em texto puro na configuração local do Claude Code, no seu computador. Não use --scope project com a chave no comando: ela iria para um arquivo que costuma entrar no Git.

Mais detalhes na documentação do Claude Code.

Cursor

Ainda não testamos no app do Cursor. Estes passos seguem a documentação do Cursor. Na CLI cursor-agent 2025.09.18, o cabeçalho não foi enviado e a conexão falhou: se acontecer com você, atualize o Cursor.

Abra ou crie o arquivo ~/.cursor/mcp.json e cole a configuração abaixo, trocando SUA_CHAVE pela sua chave. Se já houver outros servidores, acrescente só a entrada g3apply.

{
  "mcpServers": {
    "g3apply": {
      "url": "https://apply.g3infotech.app/api/mcp",
      "headers": {
        "Authorization": "Bearer SUA_CHAVE"
      }
    }
  }
}

Use o arquivo global, não o .cursor/mcp.json do projeto, para a chave não ir para o Git.

App do Claude (claude.ai, Desktop e Cowork)

Ainda não testamos. Estes passos seguem a documentação da Anthropic, que diz que o conector personalizado aceita uma credencial fixa em Request headers. A conexão sai dos servidores da Anthropic, não do seu computador, e a chave fica guardada lá.

1. Em Customize, abra Connectors.
2. Clique em + Add e depois em Add custom connector.
3. Dê um nome, cole o endereço do servidor e clique em Continue.
4. Em Authentication, escolha No sign in.
5. Em Request headers, crie o cabeçalho Authorization com o valor Bearer SUA_CHAVE, usando a sua chave.
6. Clique em Add.

Nos planos Team e Enterprise, todo mundo que usa o conector entra com a mesma credencial, ou seja, com a sua conta do G3 Apply. Nesses planos, não use a sua chave.

O arquivo claude_desktop_config.json é para servidores locais e não serve para este caso.

ChatGPT

Em teste. A documentação da OpenAI diz que o ChatGPT usa OAuth 2.1 e não envia chave de API própria. O G3 Apply agora tem OAuth, mas ainda não testamos com o ChatGPT de verdade, então não prometemos que funciona. Quando testarmos, esta página traz os passos.

O que cada permissão libera

O assistente só vê as ferramentas das permissões que você marcou. Nenhuma ferramenta envia candidatura ou e-mail, mexe em pagamento ou mostra contatos.

Envio automático: leia antes de marcar Alterar copilots

A chave não tem ferramenta para enviar candidatura. Mas, com Alterar copilots, ela pode pôr um copilot em envio automático (FULL_AUTO, com update_copilot) e ligá-lo (com resume_copilot). A partir daí, o copilot envia candidaturas sozinho.

Para isso, o assistente recebe uma proposta, confirma numa segunda chamada e ainda precisa mandar confirmFullAuto. Copilot criado por chave nasce pausado e em revisão manual.

Essas confirmações são pedidas ao assistente. Nosso servidor só vê a chamada e não sabe se você disse sim, então não deixe o cliente aprovar ferramentas sozinho com esta chave.

Revogar a chave não desliga um copilot que já está ligado. Pausar o copilot no G3 Apply para a busca e o preparo de vagas novas e também segura o que está na fila de envio até você ligar de novo. O envio que já começou termina, porque não dá para interromper, e a candidatura que você mesmo mandar enviar na tela dela segue. Para tirar uma candidatura da fila, abra-a em Candidaturas e clique em Descartar candidatura.

Limites, atividade e revogação

• 60 mensagens por minuto por chave e 30 escritas por hora por conta. Acima disso, a resposta é 429, com o tempo de espera em Retry-After.
• As chamadas de ferramenta aparecem em Atividade recente, na seção Integrações, com a chave, o IP e o resultado.
• Revogar vale na hora: a próxima chamada com aquela chave é recusada.
• A chave vence na data escolhida. Trocar a senha ou sair de todos os dispositivos também a desliga.
• Texto de vaga e de empresa vem de terceiros e pode trazer instruções escritas para enganar o assistente. O servidor avisa o assistente para tratar esse texto só como dado, mas isso não é garantia: revise o que ele propõe.

Se não conectar

• Erro 401: a chave está errada, vencida ou revogada, ou o cabeçalho não chegou. Confira o valor Bearer seguido da chave, ou gere outra.
• O cliente pede login, ou mostra um erro como Unexpected token: ele não enviou a chave e tentou OAuth, que ainda não existe aqui. Confira a configuração do cabeçalho.
• Erro 403: o pedido veio de uma página de outro site. O servidor recusa isso de propósito; use um cliente de terminal ou desktop.
• INSUFFICIENT_SCOPE: falta uma permissão. Gere uma chave nova com o que falta, porque não dá para mudar a de uma chave existente.