Blacksmith Master Guide API
Use este chatbot no seu próprio código, site ou app para celular: uma API simples de requisição/resposta, documentos OpenAPI e Postman, e Connect para que seus usuários entrem com este chatbot.
Documentação
Importe o documento OpenAPI ou a coleção do Postman para testar cada endpoint.
Exemplo de requisição
curl https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/chat \
-H "Authorization: Bearer c6k_your_key" \
-H "Content-Type: application/json" \
-d '{"messages":[{"role":"user","content":"Hello!"}],"lang":"pt"}'As requisições seguem os planos deste chatbot, as requisições diárias grátis e o saldo, assim como o chat.
Endpoints públicos
Sem chave: o perfil do chatbot e os posts do blog publicados.
curl https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master?lang=pt curl https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/posts curl https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/posts/<id>
Servidor MCP
Conecte este endereço em qualquer cliente MCP. Sem chave ele lê informações públicas e com chave pode conversar.
Use Blacksmith Master Guide no ChatGPT, Claude, Cursor ou VS Code. Com sua chave, a IA pode conversar com Blacksmith Master Guide; a chave do dono também pode gerenciar os posts do blog.
Endereço do servidor
Clientes que podem enviar cabeçalhos usam este endereço com o cabeçalho Authorization: Bearer <key>.
Endereço com chave
Para apps que não podem enviar cabeçalhos (ChatGPT, Claude.ai). A chave fica dentro do endereço: mantenha em segredo como uma senha.
Configuração passo a passo
Escolha seu app e siga os passos. Leva cerca de um minuto.
Claude (claude.ai e Claude Desktop)
- Abra o Claude e vá em Configurações, depois Conectores.
- Clique em Adicionar conector personalizado.
- Digite blacksmith-master como nome e cole o endereço com chave abaixo como URL do servidor. Deixe os campos de OAuth vazios.
- Clique em Adicionar e depois em Conectar, se o Claude pedir.
- Em um novo chat, abra o menu de ferramentas (o ícone de controles deslizantes) e ative blacksmith-master.
- Pergunte algo, por exemplo: mostre meus chatbots e o status deles.
Claude Code
- Execute este comando no seu terminal:
claude mcp add --transport http blacksmith-master https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/mcp \ --header "Authorization: Bearer your_key"
- Inicie o Claude Code e digite /mcp para verificar se blacksmith-master está conectado.
- Pergunte com palavras simples; o Claude Code chama as ferramentas de blacksmith-master quando necessário.
ChatGPT
- Abra o ChatGPT na web, vá em Configurações, depois Apps e conectores, depois Configurações avançadas, e ative o Modo desenvolvedor.
- Volte para Apps e conectores e clique em Criar.
- Digite blacksmith-master como nome e cole o endereço com chave abaixo como URL do servidor MCP.
- Escolha Sem autenticação, confirme que confia neste app e clique em Criar.
- Em um novo chat, clique no botão de mais, escolha Modo desenvolvedor e selecione blacksmith-master.
- Pergunte algo; o ChatGPT pede sua aprovação antes de ações que alteram dados.
Cursor
- Abra Cursor Settings, depois MCP, depois Add new MCP server. Você também pode editar ~/.cursor/mcp.json diretamente.
- Cole esta configuração e salve:
{ "mcpServers": { "blacksmith-master": { "url": "https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/mcp", "headers": { "Authorization": "Bearer your_key" } } } } - Verifique se blacksmith-master mostra um ponto verde e use no modo Agent.
VS Code (GitHub Copilot)
- Crie o arquivo .vscode/mcp.json no seu projeto ou execute o comando MCP: Add Server.
- Cole esta configuração e salve:
{ "servers": { "blacksmith-master": { "type": "http", "url": "https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/mcp", "headers": { "Authorization": "Bearer your_key" } } } } - Clique em Start acima do servidor, abra o Copilot Chat no modo Agent e ative as ferramentas de blacksmith-master.
Windsurf, Gemini CLI e outros clientes
- Qualquer cliente que suporte MCP remoto via Streamable HTTP funciona: use o endereço do servidor e o cabeçalho Authorization: Bearer <key>.
- Se o seu cliente só executa servidores locais (stdio), como versões antigas do Claude Desktop, adicione esta configuração. Ela usa mcp-remote e precisa de Node.js:
{ "mcpServers": { "blacksmith-master": { "command": "npx", "args": [ "-y", "mcp-remote", "https://blacksmith-master.chatbot6.com/api/v1/bots/blacksmith-master/mcp?key=your_key" ] } } } - Reinicie o cliente e procure as ferramentas de blacksmith-master.
Connect: entre com este chatbot
Permita que os usuários do seu site ou app para celular entrem com este chatbot e conversem pelo seu app. Usa OAuth 2.0 com PKCE.
Envie o usuário para a página de consentimento
/pt/connect?client_id=<client_id>&redirect_uri=<redirect_uri>&state=<state>&code_challenge=<S256(code_verifier)>&code_challenge_method=S256
Troque o código recebido por uma chave
curl https://blacksmith-master.chatbot6.com/api/v1/connect/token \
-H "Content-Type: application/json" \
-d '{"grant_type":"authorization_code","code":"<code>","client_id":"<client_id>","redirect_uri":"<redirect_uri>","code_verifier":"<code_verifier>"}'