Servidor MCP (conecte seu assistente de IA)

CHAMPREP hospeda uma sessão remota Protocolo de Contexto de Modelo servidor (MCP). Conecte-o a um cliente de IA compatível com MCP — Claude, Claude Code, Cursor, VS Code 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 no seu drive, crie faturas e muito mais, tudo por meio de conversas.

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

Ambiente	Endpoint
Produção	`https://ai-api.champrep.com/mcp`
Teste	`https://test-ai-api.champrep.com/mcp`

1. Crie uma chaveAPI

Seu assistente se autentica com uma chaveCHAMPREPAPI.

Faça login em champrep.com e abra Conta → APIChaves.
Crie uma chave e selecione sua escopos — isso determina quais ferramentas seu assistente pode usar. calendar:read disponibiliza ferramentas de calendário somente para leitura; calendar:write também disponibiliza ferramentas que criam ou alteram eventos. Conceda apenas os serviços aos quais deseja que o assistente tenha acesso.
Copie a chave (cpk_live_…). É exibido uma única vez.

A tecla funciona como você: tudo o que o assistente faz está limitado ao seu próprio plano, às políticas da sua organização e aos escopos que você escolheu. As chaves podem ser revogadas a qualquer momento na mesma página.

2. Conecte seu cliente

Claude Code

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

Cursor, VS Code, Windsurf

Adicione à configuração MCP do cliente:

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

Claude Desktop e outros clientes exclusivos do stdio

Clientes que iniciam apenas servidores MCP locais podem usar a ponte oficial — um pequeno retransmissor para o endpoint hospedado (requer Node 18 ou superior):

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

3. Experimente

Peça ao seu assistente coisas como:

“O que há na minha CHAMPREPagenda esta semana?”
“Elabore uma resposta ao e-mail mais recente na caixa de entrada de suporte.”
“Crie um ticket de trabalho para o bug de integração e atribua-o a mim.”
“Encontre a proposta do terceiro trimestre no meu drive e faça um resumo dela.”

O que o assistente pode e não pode fazer

Atua exclusivamente em seu nome. Cada chamada à ferramenta é executada com a sua identidade — a mesma instância, os mesmos limites do plano e as mesmas regras da organização que você utiliza quando acessa por contaCHAMPREP própria.
Escopo limitado. Uma chave sem mail:write Nunca expõe ferramentas de envio de e-mail ao assistente, e suas permissões de IA por serviço (configurações de IA em sua conta) também se aplicam.
Não são permitidas ferramentas destrutivas. Exclusões e outras operações irreversíveis não são disponibilizadas por meio do MCP.
Sua IA, seus tokens. O MCP não consome CHAMPREP AIcréditos — o modelo de raciocínio é do seu próprio cliente de IA.

Solução de problemas

Sintoma	Corrigir
`401` / “Credenciais ausentes”	O `Authorization: Bearer cpk_…` O cabeçalho está ausente ou a chave foi digitada incorretamente.
“ChaveAPI inválida”	A chave foi revogada, expirou ou pertence a outro ambiente (teste x produção).
Faltam ferramentas	Os escopos da chave excluem esse serviço, ou o serviço está desativado em suas configurações de permissão de IA.
`429` Limite de taxa	O assistente está em loop; tente novamente após um minuto.

Dúvidas? Entre em contato com o suporte.