Introdução

O Model Context Protocol (MCP) é um padrão aberto que permite conectar assistentes de IA (como Claude Desktop e Cursor) diretamente às APIs da Celcoin. Com o MCP, você pode ter acesso à IA da Documentação da Celcoin sem precisar sair da sua plataforma de desenvolvimento ou escrever código manualmente para cada chamada.

O MCP conectado às ferramentas do desenvolvedor permite maior produtividade nas tarefas unindo o contexto do seu produto com o contexto das APIs da Celcoin.

Para que serve?

A Celcoin disponibiliza um servidor MCP que atua como uma ponte entre o seu modelo de linguagem (LLM) e a nossa documentação.

Este MCP foi desenvolvido para:

• Entendimento e testes: compreender e validar o funcionamento das APIs da Celcoin.
• Assistência em IDEs: suporte direto em ferramentas como VS Code e Cursor para consultas e apoio na geração de scripts.
• Produtividade do desenvolvedor: agilizar o fluxo de trabalho individual ao desenvolver a integração com as nossas soluções.

Guia de Setup por Plataforma

Este guia explica como configurar o MCP da Celcoin (cel_agents) nos principais ambientes de desenvolvimento.

Endpoint do MCP: https://mcp-agents.celcoin.ai/mcp

A conexão utiliza HTTP remoto. Quando solicitado pelo servidor, a autenticação deve ser realizada pelo navegador via OAuth, sem configurar tokens manuais ou credenciais adicionais.

1. Visual Studio Code (VS Code)

Para usar o MCP da Celcoin diretamente no chat do VS Code (versão 1.102+):

1. Clique no widget "Ask AI" no canto inferior direito desta página.
2. Com o "Ask AI" aberto, clique em "Use MCP" e selecione "Add to VS Code"
3. Ao ser redirecionado para o VS Code, instale a extensão MCP Servers

Caso prefira configurar pelo terminal:

1. Execute o comando abaixo:

code --add-mcp '{"name":"cel_agents","type":"http","url":"https://mcp-agents.celcoin.ai/mcp"}'

2. Recarregue a janela do VS Code, se necessário.
3. Autorize o acesso pelo navegador quando a autenticação for solicitada.
4. Verifique se o servidor está disponível no chat e se suas ferramentas estão habilitadas.

2. Cursor

1. Abra o arquivo de configuração global ~/.cursor/mcp.json. Se ele não existir, crie-o:

{
  "mcpServers": {
    "cel_agents": {
      "type": "http",
      "url": "https://mcp-agents.celcoin.ai/mcp"
    }
  }
}

2. Salve o arquivo e reinicie o Cursor.
3. Autorize o acesso pelo navegador quando solicitado.
4. Acesse Settings > MCP e verifique se o servidor cel_agents está conectado.

3. Claude Code

O primeiro passo é registrar a fonte (o transport) de regras MCP personalizado (neste caso, o celcoin-docs) usando o terminal integrado do Claude Code:

1. Abra o Terminal Power Shell (windows10/11) (‘tecla windows + x’ pressione a tecla ‘i’) => Acesse a pasta do seu projeto.
2. Execute o comando de adição:

claude mcp add --transport http --scope user cel_agents https://mcp-agents.celcoin.ai/mcp

O comando registra o servidor cel_agents no escopo do usuário, permitindo utilizá-lo em diferentes projetos.

Para autenticar e validar a conexão:

1. Abra o Claude Code e execute:

/mcp

2. Localize o servidor cel_agents e conclua a autenticação pelo navegador, caso solicitado.
3. o terminal, execute:

claude mcp list

4. Verifique se o servidor aparece com o status de conexão esperado.

Se aparecer uma mensagem como Needs authentication, abra /mcp dentro de uma sessão do Claude Code e conclua o fluxo de autenticação.

4. Codex CLI

Opção 1 - Configuração pelo terminal

1. Execute no terminal:

codex mcp add cel_agents --url https://mcp-agents.celcoin.ai/mcp

2. Em seguida, realize a autenticação:

codex mcp login cel_agents

3. O navegador será aberto para concluir o OAuth, caso o servidor ofereça esse fluxo.
4. Para verificar a configuração:

codex mcp list

Opção 2 - Configuração manual

1. Abra o arquivo ~/.codex/config.toml e adicione:

[mcp_servers.cel_agents]
url = "https://mcp-agents.celcoin.ai/mcp"

2. Salve o arquivo e execute codex mcp login cel_agents para autenticar, se necessário.

Não adicione uma opção auth = "oauth" sem confirmar que ela é suportada pela versão do Codex CLI utilizada.

5. Outros agentes compatíveis com MCP

Para agentes que aceitam configuração de servidores MCP remotos via HTTP, utilize o formato abaixo, desde que seja compatível:

{
  "mcpServers": {
    "cel_agents": {
      "type": "http",
      "url": "https://mcp-agents.celcoin.ai/mcp"
    }
  }
}

1. Salve a configuração no arquivo MCP indicado pela documentação do agente.
2. Reinicie ou recarregue o ambiente, se necessário.
3. Conclua a autenticação OAuth pelo navegador, caso solicitada.
4. Verifique se as ferramentas do servidor estão disponíveis.
5. Solicite ao agente que execute a ferramenta permissions, caso ela esteja disponível, para verificar as permissões concedidas.