> ## Documentation Index
> Fetch the complete documentation index at: https://ibm-d95bab6e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Configure IBM i MCP Server with Cursor AI-first code editor

Cursor is an AI-first code editor with native MCP support. It provides seamless integration with MCP servers for enhanced AI capabilities.

<Note>
  **Platform Support**: macOS, Linux, Windows
  **Transport Modes**: Stdio (local) and HTTP (remote)
  **Configuration**: `.cursor/mcp.json` or Cursor settings
</Note>

## Local (Stdio) Setup

**Configuration file**: Add to Cursor settings or `.cursor/mcp.json` in your project:

```json theme={null}
{
  "mcpServers": {
    "ibmi-mcp": {
      "command": "npx",
      "args": ["@ibm/ibmi-mcp-server@latest", "-y", "--tools", "/absolute/path/to/tools"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}
```

<Warning>
  The `--tools` path must be an **absolute path**.
</Warning>

## Remote (HTTP) Setup

```json theme={null}
{
  "mcpServers": {
    "ibmi-mcp": {
      "url": "http://localhost:3010/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}
```

## Testing the Connection

1. Restart Cursor after configuration
2. Open the AI chat panel
3. Ask "What tools are available?"
4. Test with "Show me the IBM i system status"

## Troubleshooting

<AccordionGroup>
  <Accordion title="Server Not Appearing">
    * Verify JSON syntax in configuration file
    * Restart Cursor completely
    * Check that `npx -y @ibm/ibmi-mcp-server@latest` works from terminal
    * Ensure all paths are absolute
  </Accordion>

  <Accordion title="Authentication Failed">
    * Verify server is running with authentication enabled
    * Check token hasn't expired
    * Get fresh token: `node get-access-token.js --verbose`
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="SQL Tools" icon="database" href="/sql-tools/overview">
    Create custom SQL tools
  </Card>

  <Card title="Configuration" icon="gear" href="/configuration">
    Explore all configuration options
  </Card>

  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Basic server setup guide
  </Card>

  <Card title="Other Clients" icon="grid" href="/clients/overview">
    Explore other MCP clients
  </Card>
</CardGroup>

## Additional Resources

* [Cursor MCP Documentation](https://docs.cursor.com/context/model-context-protocol)
* [IBM i MCP Quick Start](/quickstart)
* [Configuration Reference](/configuration)