blazeDocs

Connect a client

Claude Code, Claude Desktop, ChatGPT and Codex.

Any MCP client that speaks Streamable HTTP works. Where a client supports OAuth you never handle a key; where it does not, send an API key header instead.

Terminal
claude mcp add --transport http blaze https://blaze.crafter.run/v1/mcp

# no browser available? use a key instead:
claude mcp add --transport http blaze https://blaze.crafter.run/v1/mcp \
  --header "Authorization: Bearer $BLAZE_KEY"

How browser clients find the OAuth flow

Browser-based clients read the WWW-Authenticate header on a 401 to start the OAuth flow, so blaze sends CORS headers that expose it. The endpoint also answers 405 to an SSE GET: it is stateless and never pushes messages, and saying so is cleaner than leaving a stream open that will never carry anything.

Database clients

The MCP tools hand an agent a connection string, and any ordinary driver can use it. For MongoDB, use the string as it is, with mongosh or the official Node driver:

mongosh
mongosh "mongodb://u_myapp_x7f2:…@mongo.blaze.crafter.run:27017/db_myapp_x7f2?tls=true&tlsAllowInvalidCertificates=true&authSource=db_myapp_x7f2"
Node.js (mongodb driver)
import { MongoClient } from "mongodb";

const client = new MongoClient(process.env.MONGODB_URL!);
const orders = client.db().collection("orders");
await orders.insertOne({ status: "paid", total: 42.5, placedAt: new Date() });

More in MongoDB. For PostgreSQL clients, check TLS for the one sslmode exception.

On this page