Working with AI agents and other apps
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.jsonand 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.
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.