Introdução

O Ask AI é a inteligência artificial da Celcoin, treinada na nossa documentação oficial para desenvolvedores. Ele entende sua pergunta e responde em segundos, com exemplo de código e o link da documentação para você conferir.

Você pode usar o Ask AI de duas formas:

• Pelo botão Ask AI, localizado em nosso site.
• No seu assistente de IA (MCP): conecte o Ask AI ao Claude, Cursor, VS Code ou outro assistente compatível e consulte a Celcoin sem sair do editor.

O Model Context Protocol (MCP) é um padrão aberto que permite ao seu assistente de IA consultar fontes externas. Com o MCP da Celcoin, ele ganha acesso direto à 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.
• Dúvidas do dia a dia: depois de integrado, consultar regras de produto, prazos, eventos de webhook, status e erros.

Importante: o Ask AI consulta apenas a documentação pública. Ele não acessa dados de conta, não executa transações e não consulta o status de operações.

Ferramentas disponíveis

Ao conectar o MCP, o seu assistente passa a ter duas ferramentas:

Guia de Setup por Plataforma

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

Endpoint do MCP: https://ask.celcoin.ai/mcp

A conexão utiliza HTTP remoto e não exige login, token ou credencial.

1. Visual Studio Code (VS Code)

Para usar o Ask AI no chat do VS Code:

1. Execute o comando abaixo no terminal:

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

2. Recarregue a janela do VS Code, se necessário.
3. Abra o chat e verifique se o servidor celcoin está disponível, com as ferramentas ask_celcoin_ai e search_celcoin_docs habilitadas.

Se preferir configurar manualmente, abra o comando MCP: Open User Configuration e adicione:

{
  "servers": {
    "celcoin": {
      "type": "http",
      "url": "https://ask.celcoin.ai/mcp"
    }
  }
}

2. Cursor

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

{
  "mcpServers": {
    "celcoin": {
      "type": "http",
      "url": "https://ask.celcoin.ai/mcp"
    }
  }
}

2. Salve o arquivo e reinicie o Cursor.
3. Acesse Settings > MCP e verifique se o servidor celcoin está conectado.

3. Claude Code

1. Abra o terminal e acesse a pasta do seu projeto.
2. Execute o comando:

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

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

3. Para validar a conexão, execute:

claude mcp list

4. Verifique se o servidor celcoin aparece como conectado. Dentro de uma sessão do Claude Code, você também pode usar o comando /mcp.

4. Codex CLI

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

1. Execute no terminal:

codex mcp add celcoin --url https://ask.celcoin.ai/mcp

2. Para verificar a configuração:

codex mcp list

Opção 2 - Configuração manual

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

[mcp_servers.celcoin]
url = "https://ask.celcoin.ai/mcp"

Salve o arquivo e reinicie o Codex CLI.

5. Outros assistentes compatíveis com MCP

Para assistentes que aceitam servidores MCP remotos via HTTP, utilize o formato abaixo, desde que seja compatível:

{
  "mcpServers": {
    "celcoin": {
      "type": "http",
      "url": "https://ask.celcoin.ai/mcp"
    }
  }
}

1. Salve a configuração no arquivo MCP indicado pela documentação do assistente.
2. Reinicie ou recarregue o ambiente, se necessário.
3. Verifique se as ferramentas ask_celcoin_ai e search_celcoin_docs estão disponíveis.

Boas práticas

• Nunca cole credenciais, tokens, certificados ou dados pessoais nos prompts. Use dados fictícios nos exemplos.
• Confira a resposta no link da documentação indicado antes de implementar. Como toda IA, o Ask AI pode ter imprecisões.
• Para casos da sua conta, incidentes e questões comerciais, use os canais de atendimento da Celcoin.