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

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 direito inferior desta página.
2. Com o "Ask AI" aberto, clique em "Use MCP" e selecione "Add to VS Code"
3. Faça o login no Kapa (não é necessário cadastro prévio)
4. Ao ser redirecionado ao VS Code, instalar a extensão MCP Servers
5. A configuração do MCP deve seguir conforme o json abaixo:

{
  "servers": {
    "celcoin-docs": {
      "type": "http",
      "url": "https://celcoin.mcp.kapa.ai"
    }
  },
	"inputs": []
}

6. No chat do assistente de IA do VS Code, coloque o comando "Use #celcoin-docs" para ativar o uso do MCP

2. Cursor

1. Vá em Settings > Features > MCP.\
2. Clique em + Add New MCP Server.\
3. Configure:

• Name: Celcoin
• Type: http
• URL: https://celcoin.mcp.kapa.ai

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 celcoin-docs
https://celcoin.mcp.kapa.ai

Explicação do Comando: ● claude mcp add: Comando base para adicionar uma nova configuração de fonte de regras ao MCP. ● --transport http: Especifica que a comunicação será feita via protocolo HTTP. ● celcoin-docs: É o nome de referência que você está dando para este conjunto de regras/repositório dentro do Claude Code. ● [https://celcoin.mcp.kapa.ai]: É o endpoint que hospeda as regras de migração e padronização específicas para a documentação da Celcoin.

Para validar que o MCP foi instalado corretamente, utilize o comando abaixo dentro do ambiente Claude-Code Terminal:

/mcp

Esse comando irá mostrar todos os MCP´s que estão instalados no seu Claude-Code Terminal.

3. Autenticação e Ativação (Login Authorization no Kapa.ai)

   1. Após adicionar o repositório, você precisará ativar o acesso, que requer uma autorização, geralmente fornecido pela plataforma Kapa.ai realizando um login na sua conta Kapa.(caso não possua uma conta, você poderá criar uma durante o processo de obtenção da autorização);

   2. com as setas, selecione o celcoin-docs , selecione a opção Authorization e aperte Enter. Você será redirecionado ao login do Kapa.ai. Após o login, você terá a confirmação do acesso;

      Obs: o "Login Authorization no Kapa" refere-se à etapa de fornecer as credenciais ou o token para que o Claude Code tenha permissão para buscar e aplicar as regras hospedadas no MCP da Celcoin (https://celcoin.mcp.kapa.ai)

Para confirmar que a fonte de regras foi instalada e ativada corretamente, execute:

claude mcp list

A lista deve incluir celcoin-docs, e o status deve indicar que está Ativo ou Autorizado.

Com a instalação e autenticação concluídas, o conjunto de regras celcoin-docs estará disponível no Painel de Ferramentas MCP do Claude Code (acessível via Paleta de Comandos: "MCP: Abrir Painel") para iniciar suas operações de consumo da nossa documentação Celcoin.