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

# Connect to MCP Server

> Connect your AI assistant to the SeekrFlow OpenAPI spec to generate working, authenticated code on demand.

The SeekrFlow MCP server implements the Model Context Protocol (MCP) to give your AI assistant direct access to the SeekrFlow OpenAPI spec. When connected, your assistant can read endpoint definitions, parameters, request and response schemas, and authentication requirements — then use that information to generate working, authenticated code without you having to look anything up manually.

For example, ask *"How do I upload a file to the AI-Ready Data Engine?"* and your assistant will:

<Steps>
  <Step>
    Retrieve the SeekrFlow OpenAPI spec.
  </Step>

  <Step>
    Locate the correct `/flow/files` endpoint definition.
  </Step>

  <Step>
    Read the required parameters, request body schema, and authentication requirements.
  </Step>

  <Step>
    Generate working code with proper authentication and request structure.
  </Step>

  <Step>
    Include response handling based on the defined response schemas.
  </Step>
</Steps>

**Supported tools:**

* VSCode
* Cursor
* Windsurf
* Other AI assistants that support remote MCP servers

## Authentication

No authentication is required to connect to the SeekrFlow MCP server.

When your AI assistant generates code that makes SeekrFlow API calls, those calls require your SeekrFlow API key in the `Authorization` header. Set your API key as an environment variable so it's available in generated code:

<CodeGroup>
  ```bash Linux / macOS theme={null}
  export SEEKR_API_KEY=your_api_key
  ```

  ```bash Windows theme={null}
  set SEEKR_API_KEY=your_api_key
  ```
</CodeGroup>

For instructions on getting your API key, see [Getting started with your API](/flow/reference/getting-started-with-your-api#get-your-api-key).

## Connect your tools

SeekrFlow hosts a remote MCP server at `https://docs.seekr.com/mcp`. Configure your AI development tools to connect to this server using the steps below.

### VSCode

<Steps>
  <Step>
    Open the Command Palette (`Cmd+Shift+P` on macOS, `Ctrl+Shift+P` on Windows/Linux).
  </Step>

  <Step>
    Select **MCP: Add Server...**.
  </Step>

  <Step>
    Select **HTTP (HTTP or Server-Sent Events)**.
  </Step>

  <Step>
    Enter `https://docs.seekr.com/mcp` for the server URL.
  </Step>

  <Step>
    Enter `seekr-api` (or any unique identifier) for the server name.
  </Step>
</Steps>

Or add the following to your VSCode MCP configuration:

<CodeGroup>
  ```json JSON theme={null}
  {
      "mcpServers": {
          "seekr-api": {
              "type": "http",
              "url": "https://docs.seekr.com/mcp"
          }
      }
  }
  ```
</CodeGroup>

### Cursor

<Steps>
  <Step>
    Open `~/.cursor/mcp.json`. If the file doesn't exist, create it with `touch ~/.cursor/mcp.json`.
  </Step>

  <Step>
    Add the following configuration:

    <CodeGroup>
      ```json JSON theme={null}
      {
          "mcpServers": {
              "seekr-api": {
                  "type": "http",
                  "url": "https://docs.seekr.com/mcp"
              }
          }
      }
      ```
    </CodeGroup>
  </Step>

  <Step>
    Restart Cursor to load the MCP connection.
  </Step>
</Steps>

### Windsurf

<Steps>
  <Step>
    Open `~/.codeium/windsurf/mcp_config.json`. If the file doesn't exist, create it with `touch ~/.codeium/windsurf/mcp_config.json`.
  </Step>

  <Step>
    Add the following configuration:

    <CodeGroup>
      ```json JSON theme={null}
      {
          "mcpServers": {
              "seekr-api": {
                  "type": "http",
                  "url": "https://docs.seekr.com/mcp"
              }
          }
      }
      ```
    </CodeGroup>
  </Step>

  <Step>
    Restart Windsurf to load the MCP connection.
  </Step>
</Steps>

### Other AI assistants

Any AI assistant that supports remote MCP servers can connect to SeekrFlow using `https://docs.seekr.com/mcp`. Refer to your tool's documentation for instructions on adding a remote MCP server.

## Troubleshooting

### Connection issues

* **Restart your editor**: MCP connections sometimes need a restart after configuration changes.
* **Verify the server URL**: Confirm you are using `https://docs.seekr.com/mcp`.

### File issues

* **Cursor**: Make sure `~/.cursor/mcp.json` exists and is valid JSON
* **Windsurf**: Check `~/.codeium/windsurf/mcp_config.json` exists and contains valid JSON.
* **JSON syntax**: Verify all quotes and brackets are correct

### Get help

* **Test your API key** by making a direct SeekrFlow API call to confirm it is active.
* Contact SeekrFlow support or see [Getting started](/flow/reference/getting-started-with-your-api) to verify your account setup.
