LLM Integration
Docs version v1 (main)Nauthera is pre-1.0, in a design-partner programUpdated
Nauthera publishes its documentation in machine-readable formats so that AI coding assistants can discover and reference it directly. This page explains how to set up your AI tools to use Nauthera docs as context.
How It Works
Nauthera exposes these endpoints, following the llms.txt proposal:
| Endpoint | Description |
|---|---|
/llms.txt | Plain-text index: what Nauthera is and its release status, the product pages, the solution, comparison and integration pages, the articles, the FAQ, the docs in sidebar order, the API reference, this MCP server and guidance for assistants |
/llms-full.txt | The same overview, the FAQ and every page of the docs sidebar as one Markdown file |
/ | Raw markdown for any individual doc page, with its description under the title; the Link header names the HTML page as canonical |
/ | Raw markdown for one endpoint's page in the API reference, generated from the OpenAPI document |
/ | The bundled OpenAPI document the API reference is generated from |
For example:
https:— full doc index/ / www. nauthera. io/ llms. txt https:— raw Installation Guide/ / www. nauthera. io/ docs/ v1/ installation. md https:— raw Introduction page/ / www. nauthera. io/ docs/ v1/ index. md
These endpoints return plain text (not HTML), making them ideal for LLM consumption.
MCP Server
Nauthera provides a Model Context Protocol (MCP)
server at https:. It speaks streamable HTTP and needs no sign-in, API
key or local install, so any assistant that supports remote MCP servers can connect to
it directly.
| Tool | Description |
|---|---|
list-docs | List all available doc pages with titles and descriptions, including one API reference page per endpoint (slugs starting with api/) |
get-doc | Get the raw markdown content of a specific doc page, or of the FAQ (faq) |
search-docs | Search docs by keyword with fuzzy matching |
list-prompts | List the ready-made task prompts from AI Prompts, with when to use each |
get-prompt | Get one of those prompts by name, as instructions to follow |
The same prompts are also served as MCP prompts. Assistants that support them, such
as Claude Code, offer them as slash commands: type / and pick one. In any other
assistant, ask for one by name, for example: Use the nauthera-docs get-prompt tool to run
add-sign-in-to-a-web-app.
Connect your assistant
Every setup below adds the same server under the name nauthera-docs. After adding it,
check that the assistant lists the server as connected, then ask it something like
Search the Nauthera docs for how to register a client.
Claude Code
claude mcp add nauthera-docs --transport http https://www.nauthera.io/mcpAdd --scope project to write it to .mcp.json in the repository and share it with your
team, or --scope user to have it in every project. Run /mcp to check the connection.
Claude Desktop and claude.ai
Remote servers are added as connectors, not in claude_:
- Open Settings → Connectors and choose Add custom connector.
- Enter the name
Nauthera Docsand the URLhttps:./ / www. nauthera. io/ mcp - Choose Add, then enable the connector for a conversation from its tools menu.
Connectors you add on claude.ai are available in Claude Desktop too. On Team and Enterprise plans, an owner may have to allow custom connectors first.
Cursor
Create or edit .cursor/mcp.json in your project root, or ~/.cursor/mcp.json for every
project:
{
"mcpServers": {
"nauthera-docs": {
"url": "https://www.nauthera.io/mcp"
}
}
}Check Cursor Settings → MCP shows the server with its tools enabled. Cursor's agent
calls list-prompts and get-prompt when you ask for a Nauthera prompt.
VS Code with GitHub Copilot
Create or edit .vscode/mcp.json in your workspace. VS Code uses servers, not
mcpServers:
{
"servers": {
"nauthera-docs": {
"type": "http",
"url": "https://www.nauthera.io/mcp"
}
}
}Choose Start above the entry, then open Copilot Chat in Agent mode: the tools
appear in its tools picker. For every workspace, run MCP: Open User Configuration
from the command palette and add the same entry there. MCP prompts appear in chat as
/.
Windsurf
Open Windsurf Settings → Cascade → MCP Servers → View raw config, which edits
~/, and add:
{
"mcpServers": {
"nauthera-docs": {
"serverUrl": "https://www.nauthera.io/mcp"
}
}
}Refresh the server list in Cascade. On Teams and Enterprise plans, an admin may have to allow remote MCP servers first.
OpenAI Codex
Codex CLI and the Codex IDE extension share ~/.codex/config.toml. Add:
[mcp_servers.nauthera-docs]
url = "https://www.nauthera.io/mcp"or run:
codex mcp add nauthera-docs --url https://www.nauthera.io/mcpRun /mcp in a Codex session to check the connection.
Gemini CLI
gemini mcp add --transport http nauthera-docs https://www.nauthera.io/mcpor add it to ~/.gemini/settings.json (or .gemini/settings.json in a project) yourself.
httpUrl is the streamable HTTP endpoint; url would mean the older SSE transport:
{
"mcpServers": {
"nauthera-docs": {
"httpUrl": "https://www.nauthera.io/mcp"
}
}
}Run /mcp in a Gemini CLI session to check the connection. MCP prompts appear as slash
commands.
Zed
Add the server under Settings → AI → MCP Servers, or in your settings.json:
{
"context_servers": {
"nauthera-docs": {
"url": "https://www.nauthera.io/mcp"
}
}
}Cline
Open the MCP Servers view in Cline, choose Configure MCP Servers, and add to
cline_mcp_settings.json. Without type, Cline assumes a local server:
{
"mcpServers": {
"nauthera-docs": {
"type": "streamableHttp",
"url": "https://www.nauthera.io/mcp"
}
}
}Other assistants
Any MCP client that supports remote servers can connect with:
| Setting | Value |
|---|---|
| URL | https: |
| Transport | Streamable HTTP (often http or streamable-http in config files) |
| Authentication | None |
A client that supports only local (stdio) servers can reach it through a bridge such as
mcp-remote: run
npx -y mcp-remote https: as the server's command.
Chat assistants without MCP, such as ChatGPT without developer mode, can still use the
docs: paste a prompt from AI Prompts, and the assistant reads
https: and the pages it lists with its web browsing.
Direct URL Access
You can also fetch docs directly without MCP, in any assistant that can browse or fetch URLs:
Fetch https: / / www. nauthera. io/ llms. txt and summarize the available docs.
For persistent access, add doc URLs to the instructions file your assistant reads on
start: CLAUDE.md for Claude Code, AGENTS.md for Codex, Cursor, Copilot and others,
GEMINI.md for Gemini CLI, .cursor/rules/ for Cursor, or
. for GitHub Copilot:
## Nauthera Docs
- Doc index: https://www.nauthera.io/llms.txt
- Endpoints: https://www.nauthera.io/docs/v1/endpoints.md
- Configuration: https://www.nauthera.io/docs/v1/configuration.mdProject rules for your assistant has a fuller snippet, with the rules for integrating your application.
Available Docs
You can find the full list of available documentation pages at:
https: / / www. nauthera. io/ llms. txt
Each entry includes the page title, URL, and a short description. All URLs ending in .md return raw markdown content.
Next Steps
- AI Prompts: copy-ready prompts for getting started, adding sign-in, protecting an API and more. The MCP server serves them as MCP prompts too.
- Quick Start: run the published Helm chart on a local kind cluster.
- Architecture: the three listeners, storage, email and the control plane.