How AI Agents Work
CNAP provides multiple ways for AI tools to access documentation:- MCP server - Enables AI tools to search and interact with CNAP documentation in real-time. Available at
https://docs.cnap.tech/mcpwith no configuration needed - Contextual menu - Quick actions available on every documentation page for connecting to AI tools, copying content, and opening conversations
- LLMs.txt files - Industry-standard files for efficient AI indexing, including a summary file and a complete documentation file
Key Features
- Zero configuration - Automatic setup through contextual menu
- Always current - Real-time data from latest documentation
- Context-aware - AI understands your specific CNAP setup
- Comprehensive - Access to all docs, APIs, and guides
- Fast - Instant answers without manual searching
MCP Server
The Model Context Protocol (MCP) server enables AI tools to search and interact with CNAP documentation in real-time. The server is available athttps://docs.cnap.tech/mcp and requires no configuration. AI tools can query the server to get up-to-date information about CNAP features, APIs, and documentation.
Contextual Menu
Every documentation page includes a contextual menu with quick actions for AI agents:- Copy page - Copy page content as Markdown for AI tools
- View as Markdown - Open page as Markdown format
- Open in AI tools - Create conversations with current page in ChatGPT, Claude, or Perplexity
- Copy MCP server URL - Copy the MCP server URL to clipboard
- Connect to editors - Auto-install MCP server in Cursor or VS Code
LLMs.txt Files
CNAP provides industry-standard llms.txt files for efficient AI indexing:- llms.txt - All pages with descriptions for quick reference
- llms-full.txt - Complete documentation in one file for comprehensive access
Supported AI Tools
CNAP’s AI agents work with various AI tools and editors:- Claude Desktop - Configure via settings file
- Claude Connectors - Add as custom connector in Claude’s web interface
- Claude Code - Add via command line interface
- Cursor - Configure through MCP settings
- VS Code - Requires MCP extension from marketplace
- Other MCP-compatible tools - Configure via settings file using MCP server URL
https://docs.cnap.tech/mcp to access CNAP documentation.
Setting Up AI Agents
The easiest way to set up AI agents is through the contextual menu on any documentation page. Open the menu and select Connect to Cursor or Connect to VS Code for automatic installation. Your AI tool will then have access to CNAP documentation. If automatic setup isn’t available for your tool, you can configure the MCP server manually. The configuration varies by tool but typically involves adding the MCP server URL (https://docs.cnap.tech/mcp) to your tool’s configuration file.
Claude Desktop
Claude Desktop
Configuration File Location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/claude/claude_desktop_config.json
claude_desktop_config.json
CNAP recommends pnpm for better caching and performance. The full path ensures compatibility across systems.
Claude Connectors
Claude Connectors
For Claude’s web interface, navigate to Claude Settings → Add custom connector, then configure:
- Name:
CNAP - URL:
https://docs.cnap.tech/mcp
Claude Code
Claude Code
Add via command line:Verify connection:
Add MCP server
Verify connection
Cursor
Cursor
Command Palette:
- Press
Cmd+Shift+P(Mac) orCtrl+Shift+P(Windows/Linux) - Search “Open MCP settings”
- Select Add custom MCP
mcp.json
VS Code
VS Code
Create
.vscode/mcp.json:.vscode/mcp.json
Requires MCP extension from VS Code marketplace.
Other MCP-Compatible Tools
Other MCP-Compatible Tools
For other AI tools that support MCP, add the CNAP MCP server URL (
https://docs.cnap.tech/mcp) to your tool’s configuration file. The exact format depends on your tool’s MCP implementation, but typically follows this pattern:Configuration format may vary based on your tool’s MCP implementation. Refer to your tool’s documentation for the exact configuration structure.
Markdown Access
Access any documentation page as Markdown by appending.md to the URL. For example, https://docs.cnap.tech/ai-agents.md returns the page content in Markdown format, making it easy for AI tools to process and understand.
Example Questions
Once connected, you can ask your AI assistant about CNAP:- “How do I create a new product in CNAP?”
- “What are the requirements for importing a cluster?”
- “How does the payment system work?”
- “What’s the difference between managed and imported clusters?”
- “How do I set up pricing for my products?”
Troubleshooting
MCP Server Not Connecting
MCP Server Not Connecting
- Verify URL:
https://docs.cnap.tech/mcp - Check internet connection
- Ensure AI tool supports MCP protocol
- Try contextual menu for automatic setup
Configuration Not Loading
Configuration Not Loading
- Check JSON syntax in config files
- Verify file permissions
- Confirm correct file location
- Restart your AI application
Outdated Information
Outdated Information
- MCP server provides real-time data
- Restart MCP connection
- Clear cached responses in AI app
- Verify correct MCP server URL
Related Topics
- Quickstart → - Get started with CNAP
- Create a product → - Package your software for sale
- Learn about workspaces → - Understand workspace organization
- GitHub integration → - Connect GitHub repositories
- Clusters → - Set up infrastructure for deployments