> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting your IDE to Cognite documentation

> Step-by-step guide to connect your development environment to Cognite's documentation through MCP server and SKILL.md integration.

> For the complete Cognite documentation index, see [/llms.txt](/llms.txt). For full page content, see [/llms-full.txt](/llms-full.txt).

This guide shows you how to connect your development environment to Cognite's documentation using two complementary approaches: the **Model Context Protocol (MCP)** server and **SKILL.md** files.

**Prerequisites**: You need a compatible AI-powered development tool (for example, Cursor, Claude Desktop, Windsurf, or VS Code with Copilot) and Node.js installed for CLI-based setup.

Both approaches enhance AI-assisted development, but serve different purposes. The following table compares the two integration approaches:

|                      | MCP Server                           | SKILL.md                             |
| -------------------- | ------------------------------------ | ------------------------------------ |
| **Purpose**          | Live documentation access            | Capability description               |
| **Content**          | Full article text and specifications | Structured capability summary        |
| **Update frequency** | Real-time                            | Automatic with documentation updates |
| **Integration**      | Requires IDE configuration           | Automatic with compatible tools      |
| **Best for**         | Detailed implementation questions    | Understanding what's possible        |

<Tip>
  Use both together for the best experience. The MCP server provides detailed information when you need it, while SKILL.md helps AI assistants understand the full scope of CDF capabilities.
</Tip>

## Connect to the Model Context Protocol (MCP) server

The [Model Context Protocol](https://modelcontextprotocol.io) is an open standard that allows AI assistants to securely access external data sources and tools. To connect your IDE to Cognite's MCP server:

<Steps>
  <Step title="Access the MCP menu">
    Click the **Copy MCP Server** button at the top right of any documentation page. This opens a dropdown menu with connection options.

    <Frame>
      <img class="illustration" src="https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/dev/guides/mintlify_contextual_menu_v1.png" alt="Documentation page header showing the Copy MCP Server button with dropdown menu options" width="40%" />
    </Frame>
  </Step>

  <Step title="Choose your connection method">
    The dropdown menu provides several options:

    <Tabs>
      <Tab title="Cursor / VS Code">
        Click **Connect to Cursor** or **Connect to VS Code** to automatically configure the MCP server in your IDE.
      </Tab>

      <Tab title="Other tools">
        <Steps>
          <Step title="Copy the MCP server URL">
            Click **Copy MCP Server** to copy the URL to your clipboard.
          </Step>

          <Step title="Add to your tool's configuration">
            Add the copied URL to your tool's MCP server configuration:

            1. Open your tool's settings.
            2. Navigate to MCP server configuration.
            3. Paste the copied URL.
            4. Save and restart your tool.
          </Step>
        </Steps>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Test the connection">
    After configuration, verify your AI-powered development tool can access Cognite documentation by asking it questions like:

    * "What authentication methods does CDF support?"
    * "Show me how to create a data model in Python."
    * "What are the rate limits for the CDF API?"

    <Check>
      If your AI assistant provides specific, accurate answers with references to current documentation, your integration is working correctly.
    </Check>
  </Step>
</Steps>

### Troubleshooting MCP server connection

<AccordionGroup>
  <Accordion title="My AI assistant doesn't respond to documentation questions">
    Verify that the MCP server is properly configured:

    1. Check your IDE's MCP server settings to confirm the Cognite server URL is listed.
    2. Restart your IDE after adding the MCP server.
    3. Ensure you're connected to the internet (the MCP server requires network access).
    4. Try asking a simple, direct question like "What is CDF?" to test basic connectivity.

    If the issue persists, check your IDE's console or logs for MCP-related error messages.
  </Accordion>

  <Accordion title="The 'Copy MCP Server' button doesn't appear">
    The button appears on all documentation pages at docs.cognite.com. If you don't see it:

    1. Refresh the documentation page.
    2. Clear your browser cache and reload.
    3. Try a different documentation page to verify the button's location.
    4. Ensure JavaScript is enabled in your browser.
  </Accordion>

  <Accordion title="Automatic configuration fails for Cursor or VS Code">
    If the automatic setup doesn't work:

    1. Use the manual configuration option from the "Other tools" tab.
    2. Verify you have the latest version of your IDE.
    3. Check that your IDE has permissions to modify configuration files.
    4. Manually add the MCP server URL to your IDE's settings file (refer to your IDE's MCP documentation).
  </Accordion>

  <Accordion title="Connection works but responses seem outdated">
    The MCP server provides real-time access to documentation. If responses seem outdated:

    1. The documentation may not have been updated yet for the feature you're asking about.
    2. Try being more specific in your questions.
    3. Verify which version of CDF or which product area you're asking about.
    4. Check the documentation directly to compare information.
  </Accordion>
</AccordionGroup>

## Install the SKILL.md capability file

The [Agent Skills specification](https://agentskills.io/specification) is a machine-readable format that describes what AI agents can accomplish with your product. Cognite automatically generates and maintains a **SKILL.md file** by analyzing our documentation. The file is discoverable through the [Well-Known Uniform Resource Identifiers](https://datatracker.ietf.org/doc/html/rfc8615) standard.

<Tabs>
  <Tab title="CLI installation">
    <Steps>
      <Step title="Install the skill using the CLI">
        Run the following command to automatically discover and install Cognite's SKILL.md file:

        ```bash theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
        npx skills add https://docs.cognite.com
        ```

        The CLI automatically finds the SKILL.md file without needing to know the exact file path.
      </Step>

      <Step title="Select your AI tools">
        Choose to install the SKILL.md file for all tools at once or select specific ones.

        <Info>
          Cognite updates the skill file with each documentation deployment. To get the latest version, re-run `npx skills add https://docs.cognite.com` or integrate the command into your CI/CD pipeline for automatic updates.
        </Info>
      </Step>

      <Step title="Verify enhanced assistance">
        Test that your AI-powered development tool understands CDF's capabilities by asking questions like:

        * "What can I do with Cognite Data Fusion?"
        * "What inputs are required to create a transformation?"
        * "What are common workflows for industrial data modeling?"

        <Check>
          If your AI-powered development tool provides capability-aware responses that understand CDF's feature set, the SKILL.md integration is working correctly.
        </Check>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Manual installation">
    <Steps>
      <Step title="Download the skill file">
        Download the SKILL.md file from [https://docs.cognite.com/skill.md](https://docs.cognite.com/skill.md).
      </Step>

      <Step title="Create a directory for the skill">
        Create a directory for the skill in your home directory, for example:

        ```bash theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
        mkdir -p ~/.skills/cognite/
        ```
      </Step>

      <Step title="Save the file">
        Save the downloaded file as `SKILL.md` in the `~/.skills/cognite/` directory.
      </Step>

      <Step title="Configure your AI tool">
        Configure your AI tool to scan the `~/.skills/` directory. Refer to your AI tool's documentation for specific skill directory configuration.
      </Step>

      <Step title="Verify enhanced assistance">
        Restart your AI tool and test that it understands CDF's capabilities by asking questions like:

        * "What can I do with Cognite Data Fusion?"
        * "What inputs are required to create a transformation?"
        * "What are common workflows for industrial data modeling?"

        <Check>
          If your AI-powered development tool provides capability-aware responses that understand CDF's feature set, the SKILL.md integration is working correctly.
        </Check>
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Tip>
  View Cognite's skill file directly at [https://docs.cognite.com/skill.md](https://docs.cognite.com/skill.md).

  You can also view the discovery index at [https://docs.cognite.com/.well-known/skills/index.json](https://docs.cognite.com/.well-known/skills/index.json).
</Tip>

### Troubleshooting SKILL.md installation

<AccordionGroup>
  <Accordion title="'npx: command not found' or 'skills: command not found'">
    This indicates Node.js or npm is not installed or not in your PATH:

    1. [Install Node.js](https://nodejs.org) from the official download page (includes npm and npx).
    2. After installation, restart your terminal.
    3. Verify installation by running `node --version` and `npm --version`.
    4. Try the `npx skills add` command again.
  </Accordion>

  <Accordion title="CLI reports 'No compatible tools detected'">
    The CLI couldn't find supported AI tools on your system:

    * Ensure you have at least one compatible tool installed (Cursor, Claude Desktop, Windsurf, VS Code with Copilot).
    * Verify the tool is properly installed and has been launched at least once.
    * Check that the tool's configuration directory exists in your home directory.
    * You can still manually download the SKILL.md file from [docs.cognite.com/skill.md](https://docs.cognite.com/skill.md) and add it to your tool's configuration.
  </Accordion>

  <Accordion title="Installation succeeds but AI doesn't understand CDF capabilities">
    The skill may not be loaded by your AI tool:

    1. Restart your AI tool after installation.
    2. Verify the skill file was installed by checking your tool's skills directory.
    3. Some tools require explicit skill activation - check your tool's documentation.
    4. Try asking explicitly: "What skills are available?" or "What is in the Cognite skill?"
    5. The skill describes capabilities but doesn't replace the MCP server for detailed documentation queries.
  </Accordion>

  <Accordion title="How do I update to the latest SKILL.md version?">
    To update your installed skill:

    1. Run `npx skills add https://docs.cognite.com` again (it will update existing installations).
    2. Restart your AI tool to load the updated skill.
    3. For automated updates, add the command to your development environment setup script or CI/CD pipeline:

    ```bash theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
    # Update Cognite skill on environment setup
    npx skills add https://docs.cognite.com
    ```
  </Accordion>
</AccordionGroup>

## Privacy and security

<Info>
  **Data privacy**: Both the MCP server and SKILL.md file are read-only and provide access only to public documentation. They do not access your code, CDF projects, or any private data.
</Info>

### MCP server security

The MCP server provides read-only access to public Cognite documentation content, API reference specifications, and code examples. It operates with direct IDE integration without sharing your data with external services.

The server does not access your source code, CDF projects, development environment, or API keys. It cannot execute code on your machine and serves only as a documentation lookup tool for your AI assistant.

### SKILL.md security

The SKILL.md file contains capability descriptions, required parameters, and common workflow patterns. It's automatically generated from public documentation and provides your AI assistant with structured information about what CDF can do.

The file does not contain executable code, scripts, or access to your projects or data. No credentials or sensitive information are included. Your AI agent may implement additional protections like sandboxing, confirmation prompts, and usage logging when working with skills.

<Tip>
  For more information about how agents integrate skills securely, see the [Agent Skills integration guide](https://agentskills.io/integrate-skills).
</Tip>

## Next steps

* [Development quickstart](/dev/quickstart) - Start building with the CDF API using your newly connected tools.
* [Python SDK](/dev/sdks/python/) - Begin integrating CDF with AI-assisted Python development.