# Working with AI agents and other apps

Updated: 2026-11-04

IT4S has an MCP server, so AI agents like Claude (Claude.ai, Claude Desktop, Claude Code), Cursor and any other MCP-capable app can read and change issues **as you**, with only your rights. Claude is our reference and the best tested.

## Connect Claude

- **Claude.ai / Claude Desktop:** Settings › Connectors › *Add custom connector* › `https://mcp.it4s.at/mcp`.
- **Claude Code:** `claude mcp add --transport http it4s https://mcp.it4s.at/mcp`, then `/mcp` › *Authenticate*.
- **Cursor:** add `{ "mcpServers": { "it4s": { "url": "https://mcp.it4s.at/mcp" } } }` to `~/.cursor/mcp.json` and click *Connect*.

IT4S opens in the browser: sign in and choose what the app may do:

| Option | Means |
|---|---|
| Read | always: projects, issues, comments, files you can see |
| Write | create and change issues, comments, worklogs, documentation in your name |
| Workspace Administration | workspace admins only, off by default: create projects, see which integrations are set up |

Everything Claude changes appears in the history as "<your name> via Claude". Ask it things like *"What's on my plate today?"*, *"Create a bug in WEB: the login button does nothing on Safari"*, *"Log 2 hours on WEB-42 for today"*, *"Write release notes for 2.4"*, or *"Implement WEB-87"* (prompt `implement_issue`).

Claude can also read the **Estimate Report** (`get_estimate_report`): *"How much is epic WEB-12 estimated at, and what would it cost at 95 € an hour plus 10 %?"* It answers with the totals and group sums like the Time › Estimate Report page, counting a parent and its children once; ask for the issues to get the list.

**Components and project groups:** Claude knows the components of a project (`list_components`) and the project groups (`list_project_groups`). It can put an issue into a component (*"Create a bug in FLEET for the Driver App: photos get lost offline"*), find issues of a component (*"Open bugs of the API component"*), create a release for one component (*"Create release DA 1.2 for the Driver App"*), and sum the Time or Estimate Report per project group (*"How many hours went into the Fleet group last month?"*).

**Watching:** *"Watch WEB-42"* or *"Stop watching WEB-42"* (`watch_issue`) works like the Watch button: you then get an email for every new comment on the issue.

A connected app can also work as a named agent; see [Agents](https://it4s.at/en/help/guide/agents/).

## Disconnect

Admins see all connections under *Administration › Connected Apps* and can revoke them; the app loses access within a minute.

## API tokens

For scripts and tools without sign-in: account menu › **API Tokens** › *Add Token*: name, scopes (Read, Write, Admin) and expiry. The token is shown once; keep it secret. Use it as `Authorization: Bearer it4s_pat_…`. The API documentation is in your workspace at `yourcompany.it4s.at/api/docs`.