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

# JetBrains AI

> Set up tk with JetBrains AI Assistant for AI-powered issue tracking

Use tk with [JetBrains AI Assistant](https://www.jetbrains.com/ai/) to manage issues from IntelliJ IDEA, PyCharm, WebStorm, Rider, GoLand, and other JetBrains IDEs.

***

## What is JetBrains AI Assistant?

[JetBrains AI Assistant](https://www.jetbrains.com/ai/) is an AI coding companion built into all JetBrains IDEs. Starting with version 2025.1, it supports MCP servers for extending its capabilities. With 16M+ developers across the JetBrains ecosystem, AI Assistant brings tk integration to IntelliJ, PyCharm, WebStorm, Rider, GoLand, CLion, and more.

***

## MCP Integration

Install the [`ticket-mcp`](https://pypi.org/project/ticket-mcp/) MCP server to give JetBrains AI Assistant direct access to your issues.

### Setup via Settings UI

1. Go to **Settings > Tools > AI Assistant > Model Context Protocol (MCP)**
2. Click the **+** button to add a new server
3. Configure the server:
   * **Name:** `ticket-mcp`
   * **Transport:** STDIO
   * **Command:** `uvx`
   * **Arguments:** `ticket-mcp`
4. Click **Apply** and **OK**

### Setup via JSON

Alternatively, paste this JSON in the MCP configuration dialog:

```json theme={null}
{
  "mcpServers": {
    "ticket-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["ticket-mcp"]
    }
  }
}
```

<Accordion title="Requirements">
  **uv** installed via: `curl -LsSf https://astral.sh/uv/install.sh | sh`

  **Python** version 3.10 or higher (installed automatically by uv)

  **JetBrains IDE** version 2025.1 or later with AI Assistant plugin
</Accordion>

<Tip>
  If you already have ticket-mcp configured in Claude Desktop, click **Import from Claude** in the MCP settings to import it automatically.
</Tip>

### Verify Installation

1. Open the AI Chat panel in your JetBrains IDE
2. Enable **Codebase** mode (toggle at the top of the chat window)
3. Ask: *"What tk tools are available?"*
4. AI Assistant should list the ticket-mcp tools

<Info>
  MCP tools only work when **Codebase** mode is enabled in the AI chat window, or when using edit mode (which includes it implicitly).
</Info>

***

## Supported IDEs

JetBrains AI Assistant with MCP support works across the full IDE family:

<CardGroup cols={3}>
  <Card title="IntelliJ IDEA" icon="java">
    Java, Kotlin, Scala
  </Card>

  <Card title="PyCharm" icon="python">
    Python
  </Card>

  <Card title="WebStorm" icon="js">
    JavaScript, TypeScript
  </Card>

  <Card title="Rider" icon="hashtag">
    C#, .NET
  </Card>

  <Card title="GoLand" icon="golang">
    Go
  </Card>

  <Card title="CLion / RustRover" icon="rust">
    C, C++, Rust
  </Card>
</CardGroup>

***

## Workflow Tips

### Starting a Session

Ask AI Assistant: *"Run tk triage and show me what I should work on today"*

### Creating Issues

Ask AI Assistant: *"Create a feature request for adding OAuth support, priority 1"*

AI Assistant will run:

```bash theme={null}
tk create "Add OAuth support" -t feature -p 1
```

### Closing Work

Ask AI Assistant: *"Resolve tk-abc123, I just merged the fix"*

### Dependency Management

Ask AI Assistant: *"Show the dependency tree for tk-xyz789"*

### Code-to-Issue Workflow

Ask AI Assistant: *"Look at the TODO comments in this file and create tk issues for each one"*

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="MCP option not in settings">
    MCP support requires JetBrains 2025.1 or later. Update your IDE and ensure the AI Assistant plugin is installed and up to date.
  </Accordion>

  <Accordion title="AI Assistant doesn't use tk tools">
    Enable **Codebase** mode in the AI chat window. MCP calls only work when Codebase mode is active.
  </Accordion>

  <Accordion title="Server fails to start">
    Check that `uvx` is in your system PATH. Open the terminal inside your JetBrains IDE and run `uvx ticket-mcp --help` to verify it works. Check the AI Assistant logs for error details.
  </Accordion>

  <Accordion title="Slow tk commands">
    Enable caching with `tk cache info` to verify the analytics cache is working. Cached responses return in under 10ms.
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="CLI Reference" icon="terminal" href="/cli-reference/commands">
    Complete tk command documentation
  </Card>

  <Card title="MCP Server" icon="plug" href="/integrations/mcp">
    Deep dive into MCP server capabilities
  </Card>

  <Card title="Graph Analytics" icon="chart-network" href="/concepts/graph-analytics">
    Learn about PageRank and dependency analysis
  </Card>

  <Card title="JetBrains AI Docs" icon="book" href="https://www.jetbrains.com/help/ai-assistant/mcp.html">
    Official JetBrains AI Assistant MCP documentation
  </Card>
</CardGroup>

***

## Sources

* [JetBrains AI Assistant MCP Documentation](https://www.jetbrains.com/help/ai-assistant/mcp.html)
* [Configure an MCP Server in JetBrains](https://www.jetbrains.com/help/ai-assistant/configure-an-mcp-server.html)
* [IntelliJ IDEA 2025.1 and MCP](https://blog.jetbrains.com/idea/2025/05/intellij-idea-2025-1-model-context-protocol/)
* [MCP Documentation](https://modelcontextprotocol.io)