OAUTH 2.0
DEVELOPER TOOLS
Connect to Mintlify MCP. Read and edit documentation pages, manage navigation nodes, search content, and publish changes via pull requests from your AI...
from langchain_mcp_adapters.client import MultiServerMCPClient
from scalekit import ScalekitClient
client = ScalekitClient(env_url=ENV_URL, client_id=CLIENT_ID, client_secret=SECRET)
token = client.agent.get_token(user_id="user_id", connector="mintlifymcp")
mcp = MultiServerMCPClient({
"mintlifymcp": {
"url": "https://mcp.scalekit.com/mintlifymcp",
"headers": {"Authorization": "Bearer " + token}
}
})
tools = await mcp.get_tools()import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";
const client = new ScalekitClient({ envUrl, clientId, clientSecret });
const token = await client.agent.getToken({ userId: "user_id", connector: "mintlifymcp" });
const openai = new OpenAI();
// Connect to MCP at https://mcp.scalekit.com/mintlifymcp
// Pass: Authorization: Bearer + tokenimport Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";
const client = new ScalekitClient({ envUrl, clientId, clientSecret });
const token = await client.agent.getToken({ userId: "user_id", connector: "mintlifymcp" });
const anthropic = new Anthropic();
// Connect to MCP at https://mcp.scalekit.com/mintlifymcp
// Pass: Authorization: Bearer + tokenfrom google.adk.agents import LlmAgent
from scalekit import ScalekitClient
client = ScalekitClient(env_url=ENV_URL, client_id=CLIENT_ID, client_secret=SECRET)
token = client.agent.get_token(user_id="user_id", connector="mintlifymcp")
# Connect to MCP at https://mcp.scalekit.com/mintlifymcp
# Pass: Authorization: Bearer + token
// shared token
audit → bot_service_account
// scalekit
audit → user_abc ✓
Does the agent access Mintlify as the user or as a shared key?
As the user. Each workspace member authorizes once and Scalekit resolves their credential at request time. Audit logs attribute every action to that user, not a shared service account.
Where is the Mintlify OAuth token stored?
In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Tokens never appear in prompts, logs, or LLM context.
Can I limit what the agent is allowed to do in Mintlify?
Yes. Pass a tool name filter to listScopedTools so the DevOps agent only sees the subset you authorize. Pre-API-call scope checks block out-of-policy actions before the request reaches Mintlify.
What happens when a user revokes Mintlify access?
The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.
Do docs edits go straight to production?
No. Page edits and navigation changes go through Mintlify's branch and pull request flow, attributed to the authorizing user. Nothing publishes without the review step your repo enforces.
