Pular para o conteúdo
Documentation

Servidor MCP (conecte seu assistente de IA)

CHAMPREP hospeda um servidor remoto Protocolo de Contexto de Modelo servidor (MCP). Conecte-o a qualquer cliente de IA compatível com MCP — Claude (claude.ai e versão para desktop), ChatGPT, Claude Code, Codex, Cursor, VS Code, Windsurf e outros — e seu assistente poderá agir com base em seu CHAMPREP conta: liste e agende eventos no calendário, leia e redija e-mails, gerencie quadros de trabalho, pesquise em seu drive, crie faturas, notas, documentos e planilhas, e muito mais, tudo por meio de conversas.

:::cuidado[Ponto de extremidade atualizado: use /mcp/v1] O ponto de extremidade agora está versionado. Conecte-se a https://ai-api.champrep.com/mcp/v1. O antigo, sem versão https://ai-api.champrep.com/mcp é desativado — as solicitações para ele são recusadas com uma mensagem solicitando que você mude. Se o seu cliente ainda estiver apontado para /mcp, altere a URL para /mcp/v1 (usuários do npm-bridge em npx -y @champrep/mcp detectarão automaticamente o novo endpoint na próxima execução). :::

Não há nada a instalar para os clientes modernos. O servidor está hospedado em:

https://ai-api.champrep.com/mcp/v1

O raciocínio do assistente é executado em seu cliente de IA com o modelo do seu cliente — CHAMPREP as chamadas MCP não consomem nenhum dos seus CHAMPREP AI créditos. Cada chamada à ferramenta é executada com a sua própria identidade e está sujeita ao seu plano, às políticas da sua organização e (para API chaves) aos escopos que você escolheu.

Existem duas maneiras de se conectar. Ambas são totalmente compatíveis — escolha de acordo com a situação:

Login pelo navegador (OAuth)API chave
Ideal paraPessoas que utilizam um aplicativo de IA de forma interativaScripts, CI, servidores, ferramentas sem interface gráfica
ConfiguraçãoCole a URL; aprove no seu navegadorCrie uma chave uma vez; cole-a na configuração
Segredos a serem gerenciadosNenhuma — nenhuma chave chega a entrar na configuração do clienteVocê armazena a cpk_… chave na configuração do cliente
Amplitude de acessoSua conta completa (como se estivesse conectado)Apenas o escopos você concede a chave (por exemplo, apenas calendar:read)
Funciona emclaude.ai, Claude Desktop, ChatGPT, Claude Code, Codex, Cursor, VS Code, WindsurfTudo, incluindo clientes sem navegador
VencimentoAs sessões são atualizadas automaticamente; revogue a qualquer momentoData de validade opcional; revogue a qualquer momento
Revogar emDesconecte-se no clienteConta → APIChaves em champrep.com

Regra geral: se houver uma pessoa na frente do cliente, use o login pelo navegador. Se for uma máquina, use uma chaveAPI de API com os escopos mais restritos necessários para realizar a tarefa.

Opção A: Faça login com seu navegador (recomendado)

Seção intitulada “Opção A: Faça login com seu navegador (recomendado)”

Adicione a URL do servidor com sem chave ou cabeçalhos. Seu cliente descobre o CHAMPREPfluxo de login automaticamente (OAuth 2.1 com registro dinâmico), abre seu navegador em uma página de consentimentoCHAMPREP e se conecta após sua aprovação. Se você já estiver conectado a CHAMPREPnesse navegador, será direcionado diretamente para a tela de aprovação; se estiver conectado a várias CHAMPREPcontas, você escolhe qual delas deseja conectar.

  1. Configurações → Conectores → Adicionar conector personalizado.
  2. Cole https://ai-api.champrep.com/mcp/v1 e salve.
  3. Seu navegador abre a página de consentimentoCHAMPREP — analise-a e clique Permitir.
  4. Em qualquer bate-papo, ative o CHAMPREPconector no menu de ferramentas e basta perguntar: “Verifique meu e-mailCHAMPREP em busca de mensagens não lidas.”

Os conectores exigem um plano do ChatGPT com modo de desenvolvedor (Configurações → Conectores → Avançado → Modo de desenvolvedor).

  1. Configurações → Conectores → Criar (ou Adicione o conector).
  2. Dê um nome a ela CHAMPREP, defina a URL do servidor MCP como https://ai-api.champrep.com/mcp/v1, escolha OAuth autenticação e salve.
  3. Aprove a página de consentimentoCHAMPREP quando o navegador for aberto.
Terminal window
claude mcp add --transport http champrep https://ai-api.champrep.com/mcp/v1

Em seguida, execute /mcp, selecione champrep, e escolha Autentique-se — seu navegador abre a página de consentimento.

Configurações → MCP → Adicionar novo servidor MCP, ou adicione a ~/.cursor/mcp.json:

{
"mcpServers": {
"champrep": { "url": "https://ai-api.champrep.com/mcp/v1" }
}
}

Quando o Cursor informar que o servidor precisa de autenticação, siga as instruções de login.

Adicione um servidor MCP HTTP com URL https://ai-api.champrep.com/mcp/v1 nas configurações do MCP do cliente. Ambos suportam o fluxo OAuth: a primeira conexão abre a página de consentimentoCHAMPREP.

  1. Faça login em champrep.com e abra Conta → APIChaves.
  2. Crie uma chave e selecione seus escopos — estes determinam quais ferramentas o assistente pode utilizar. calendar:read expõe ferramentas de calendário somente leitura; calendar:write isso também expõe ferramentas que criam ou alteram eventos. Conceda acesso apenas aos serviços que você deseja que fiquem acessíveis.
  3. Copie a chave (cpk_live_…). É exibido uma única vez.

Código do Claude:

Terminal window
claude mcp add --transport http champrep https://ai-api.champrep.com/mcp/v1 \
--header "Authorization: Bearer cpk_live_YOUR_KEY"

Cursor / VS Code / Windsurf (mcp.json(configuração no estilo):

{
"mcpServers": {
"champrep": {
"url": "https://ai-api.champrep.com/mcp/v1",
"headers": { "Authorization": "Bearer cpk_live_YOUR_KEY" }
}
}
}

Codex CLI (~/.codex/config.toml) — O Codex se comunica com servidores stdio; portanto, utilize o pacote bridge:

[mcp_servers.champrep]
command = "npx"
args = ["-y", "@champrep/mcp"]
env = { CHAMPREP_API_KEY = "cpk_live_YOUR_KEY" }

Claude Desktop (configuração stdio) e outros clientes exclusivos para stdio — o @champrep/mcp o bridge encaminha um servidor stdio local para o endpoint hospedado:

{
"mcpServers": {
"champrep": {
"command": "npx",
"args": ["-y", "@champrep/mcp"],
"env": { "CHAMPREP_API_KEY": "cpk_live_YOUR_KEY" }
}
}
}

Se CHAMPREP_API_KEY Se estiver faltando, a ponte abre seu navegador na páginaAPI “Chaves” e exibe instruções, em vez de apresentar uma falha silenciosa.

HTTP bruto (para suas próprias integrações — JSON-RPC 2.0 simples). Passe a chave por meio de uma variável de ambiente, em vez de diretamente no comando, para que ela não fique no histórico do seu shell :

Terminal window
export CHAMPREP_API_KEY="cpk_live_..." # from Account -> API Keys
curl https://ai-api.champrep.com/mcp/v1 \
-H "Authorization: Bearer $CHAMPREP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Seu cliente MCP controla se, quando e como ele solicita que você confirme uma chamada de ferramenta . O Orientação sobre interação com o usuário na especificação do MCP recomenda supervisão humana e solicitações de confirmação, mas não exige um modelo de interação específico. A exibição de solicitações depende do cliente e de suas configurações, incluindo quaisquer permissões salvas ou regras de aprovação automática.

CHAMPREP fornece anotações de ferramentas para ajudar os clientes a avaliar cada operação:

  • Ferramentas somente de leitura (listar eventos, pesquisar e-mails, ler notas …) têm readOnlyHint: true.
  • Ferramentas que alteram elementos (enviar e-mail, criar eventos, fazer upload de arquivos …) têm readOnlyHint: false.
  • Ferramentas destrutivas tenha destructiveHint: true e permanecem oculta, a menos que o acesso destrutivo esteja habilitado (próxima seção).

As anotações das ferramentas descrevem o comportamento. Elas não exigem uma caixa de diálogo de confirmação nem garantem um aviso antes de cada chamada, mesmo para ferramentas destrutivas. Verifique as configurações de aprovação do seu cliente antes de permitir alterações.

Para ações comuns do MCP, CHAMPREPdepende do tratamento de consentimento do cliente em vez de exigir um segundo cartão de aprovaçãoCHAMPREP. O servidor não verifica de forma independente se o cliente exibiu uma solicitação.

CHAMPREP Ainda assim, são aplicadas restrições de conexão, escopos de APIchaves aplicáveis, autorização de serviço, políticas da organização e limites de taxa. As ações encaminhadas pelo executor de ações CHAMPREPdo também passam por verificações de segurança e são registradas na sua conta Registro de atividades, com Desfazer onde for compatível. O consentimento do cliente não pode anular uma recusa do lado do servidor ou uma aprovação exigida pela organização; ações que exijam aprovação CHAMPREPespecífica podem ser recusadas pelo MCP.

Por padrão, o servidor oculta ferramentas que excluem ou limpam dados permanentemente — excluindo pastas da unidade, eliminando notas, removendo registros e ações semelhantes. Se o senhor tiver uma limpeza real a ser feita e desejar a ajuda do seu assistente, a conexão deve permitir ações destrutivas e o cliente deve solicitá-las adicionando ?destructive=true para a URL do servidor:

https://ai-api.champrep.com/mcp/v1?destructive=true

Utilize essa URL em qualquer lugar onde uma URL seja aceita (conector claude.ai, Claude Code, Cursor, ChatGPT). Para a ponte stdio, defina uma variável de ambiente em vez disso:

"env": {
"CHAMPREP_API_KEY": "cpk_live_YOUR_KEY",
"CHAMPREP_ENABLE_DESTRUCTIVE": "true"
}

A configuração de sinalizador de URL ou ponte, por si só, não substitui as permissões da conexão. Uma conexão somente leitura, um serviço não permitido ou o acesso destrutivo desativado ainda impedem que a ferramenta fique disponível.

O senhor é responsável pelo que o seu assistente faz com essas ferramentas. Dados excluídos podem não ser recuperáveis. Ferramentas destrutivas ainda exigem os escopos de chave API apropriados, como os de um serviço :write escopo ou seu escopo de exclusão separado, quando aplicável. Elas ainda mantêm destructiveHint, mas o fato de você ver ou não uma solicitação de confirmação depende do seu cliente e de sua configuração. As verificações do lado do servidor e a auditoria de ações descritas acima ainda se aplicam. Algumas ações destrutivas oferecem suporte a Desfazer na página “Atividade” da sua conta — mas considere cada exclusão como definitiva.

Independentemente desse sinalizador, algumas coisas são nunca Disponível no MCP: operações administrativas, ferramentas de execução de código e exclusão de conta. As únicas exceções à regra de execução de código são o início de uma compilação de pré-visualização de QA ou de uma sessão de IDE na nuvem de QA: ambas são executadas na sandbox isolada do QA, após sua aprovação (consulte MCP para Código, CI, Runner Farm e QA).

As ferramentas abrangem toda a plataforma, sempre como você: Calendar (eventos, agendamentos, disponibilidade), Mail (ler, pesquisar, rascunho, enviar, etiquetas, regras), Drive (pesquisar, arquivos, pastas, compartilhamento), Notes, Meetings (agenda, resumos, gravações), Work (quadros, tickets), Docs (documentos, comentários, edições sugeridas, versões, exportação), Planilhas (pastas de trabalho, intervalos, fórmulas, formatação, validação, formatação condicional, proteção, comentários, versões, exportação), Faturas, Forms, Contacts, Gráficos, CHAMPREP Código, Fazenda de Executores, QA e Learn. As ferramentas exatas que aparecem dependem do seu plano, das políticas da sua organização, das suas permissões de IA por serviço e (para API chaves) dos escopos da chave.

Para CHAMPREP Code (projetos, planos de clonagem, pipelines, registros de tarefas, executores), Runner Farm e QA, consulte MCP para Código, CI, Runner Farm e QA: o que o assistente pode fazer, exemplos de solicitações, o que precisa de sua aprovação e o que permanece nos aplicativos da web.

Tente estas soluções primeiro:

  • “O que há na minha CHAMPREPagenda esta semana?”
  • “Tenho e-mails não lidos? Resuma tudo o que for importante.”
  • “Encontre os contratos em PDF deste mês no meu Drive.”
  • “Crie um ticket de trabalho intitulado ‘Renovar certificados SSL’ no meu painel de operações.”
  • “Crie um documento no Docs chamado ‘Plano do 4º trimestre’ com seções para metas, riscos e responsáveis.”
  • “Na minha pasta de trabalho ‘Orçamento mensal’, destaque todas as despesas acima de 500.”

Browser Relay Bridge (extensão do Chrome) e Eve AI

Seção intitulada “Browser Relay Bridge (extensão do Chrome) e Eve AI”

Além das ferramentas de serviço em nuvem, o CHAMPREP para a extensão do Chrome pode conectar seu próprio navegador ao Eve:

  • Ativar Permita que o Eve utilize este navegador nas configurações da extensão.
  • O Eve funciona na web, no aplicativo para desktop, em Eve AI para VS Codee no agente de terminal (eve / champrep ai) pode, então, ler a guia ativa, listar as guias e capturar capturas de tela e, após a aprovação de cada ação, navegar, clicar ou preencher um campo.
  • O Eve nunca interage com sites de e-mail, bancos, pagamentos ou login e nunca digita em campos de senha, código único ou dados de cartão.

  • API chaves — visualize, defina o escopo, expire e revogue em Conta → APIChaves. A revogação entra em vigor imediatamente.
  • Logins no navegador — desconecte o conector dentro do cliente de IA. O(a) senhor(a) também pode sair da conta CHAMPREPnesse navegador; novos tokens não poderão mais ser emitidos para ele.
  • Toda ação autônoma aparece na sua conta Registro de atividades com o que foi executado, quando, de onde — e a opção “Desfazer”, quando disponível.

  • 120 solicitações MCP por minuto por identidade. Automações mais complexas devem utilizar a desenvolvedor API com chaves de escopo de serviço.
  • As chamadas da ferramenta atingem as mesmas cotas por plano que o restante da sua conta — um assistente não pode exceder o que o senhor mesmo pode fazer.

SintomaCausa provável e solução
O cliente informa que é necessária autenticação e nada é abertoSeu cliente pode não ser compatível com o MCP OAuth — utilize uma chaveAPI (Opção B).
Invalid API keyA chave foi revogada, expirou ou foi digitada incorretamente. Crie uma nova em Conta → APIChaves.
Unknown or unavailable toolA ferramenta está fora dos escopos da sua chave, foi desativada pelas suas permissões de IA ou de conexão, ou é destrutiva sem que haja tanto a permissão de conexão quanto o ?destructive=true consentimento.
Uma ferramenta é executada sem solicitação de confirmaçãoA exibição de solicitações é controlada pelo seu cliente MCP e suas configurações de aprovação. As anotações da ferramenta, incluindo destructiveHint, não garantem uma solicitação. Verifique as permissões salvas e as regras de aprovação automática nesse cliente.
Uma ferramenta de gravação é recusada com uma mensagem de limiteAs restrições do lado do CHAMPREPservidor (limites diários, proteção contra abusos) recusaram a solicitação — a mensagem explica o motivo. Tente mais tarde ou reduza o volume.
A página de consentimento exibe a mensagem “Sessão expirada”A aprovação ficou inativa por tempo demais. Execute novamente o fluxo de conexão a partir do cliente.
Funciona no teste no navegador, mas não a partir de um servidor/CIUtilize uma chaveAPI — o login no navegador gera tokens apenas de forma interativa.
429 respostasVocê atingiu o limite por minuto; aguarde um pouco e tente novamente.

Ponto de extremidade: https://ai-api.champrep.com/mcp/v1.