MCP Documentation Service

--- title: Cursor Integration Guide description: Guide for integrating MCP Docs Service with Cursor author: Claude date: 2024-03-12T00:00:00.000Z tags: - guide - cursor - integration status: published order: 3 --- # Cursor Integration Guide This guide explains how to integrate the MCP Docs Service with Cursor to enable AI-powered documentation management. ## Prerequisites - [Cursor](https://cursor.sh/) installed on your machine - A project with documentation in markdown format ## Setting Up MCP Docs Service in Cursor To integrate MCP Docs Service with Cursor, you need to configure it in your project's `.cursor/mcp.json` file. 1. Create a `.cursor` directory in your project root if it doesn't exist: ```bash mkdir -p .cursor ``` 2. Create or edit the `mcp.json` file in the `.cursor` directory: ```bash touch .cursor/mcp.json ``` 3. Add the following configuration to the `mcp.json` file: ```json { "mcpServers": { "docs-manager": { "command": "npx", "args": ["-y", "mcp-docs-service", "/path/to/your/docs"] } } } ``` Replace `/path/to/your/docs` with the path to your documentation directory. This can be a relative path (e.g., `./docs`) or an absolute path. Alternatively, you can use the flag-based format: ```json { "mcpServers": { "docs-manager": { "command": "npx", "args": ["-y", "mcp-docs-service", "--docs-dir", "/path/to/your/docs"] } } } ``` Both formats are supported as of version 0.2.8. ## Using with MCP Inspector If you're using the MCP Inspector to test the service, you can use the special `mcp-docs-inspector` entry point which is designed to work better with the MCP Inspector: ```json { "mcpServers": { "docs-manager": { "command": "npx", "args": ["-y", "mcp-docs-inspector", "/path/to/your/docs"] } } } ``` This entry point handles the argument format used by the MCP Inspector more reliably. ## Using MCP Docs Service in Cursor Once you've configured the MCP Docs Service, you can use it in Cursor by asking Claude to perform documentation-related tasks. Here are some examples of what you can ask Claude to do: - "Create a new documentation page for our API authentication" - "Update the installation guide to include the new configuration options" - "Find all documentation related to user authentication" - "Generate a navigation structure for our documentation" - "Check the health of our documentation and identify any issues" Claude will use the MCP Docs Service to perform these tasks, making it easy to manage your documentation without leaving your IDE. ## Troubleshooting If you encounter issues with the MCP Docs Service in Cursor, try the following: 1. **Check your configuration**: Make sure the path to your documentation directory is correct in the `mcp.json` file. 2. **Verify the docs directory exists**: The documentation directory must exist before you can use the MCP Docs Service. 3. **Check Cursor logs**: Cursor logs may contain information about any errors that occurred when trying to use the MCP Docs Service. 4. **Restart Cursor**: Sometimes, restarting Cursor can resolve issues with MCP services. For more detailed troubleshooting, see the [Troubleshooting Guide](troubleshooting.md).