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

# Code-it MCP

> Start and steer agents from any MCP client.

Code-it serves an MCP server over streamable HTTP from the API (`api.aiml-code-it.automat-it.io`). It exposes the same operations as the web app. Full list: [MCP tools](https://docs.aiml-code-it.automat-it.io/reference/mcp-tools.md).

## Connect a client

**1. Create a token**

In the web app, open **Settings** and the **Code-it MCP access** section (admin). Create a token, choose which tool groups it gets, whether it may call write tools, and which developers' agents it can see (owner scope).

**2. Copy the connection**

The same section shows the endpoint and ready-to-paste config snippets for Kiro and Cursor. Use the endpoint it shows. This site does not repeat the exact path.

**3. Send the token as a bearer header**

```text theme={null}
Authorization: Bearer <token>
```

Treat the token as a secret.

## Starting agents well

* **Prefer a ticket.** Call `create_agent` with `ticketKey` when the work has an Asana task. The agent gets the task as its brief.
* Use `workBranch` only when there is no ticket, or when you need an existing branch whose name is not the ticket key.
* Call `runner_status` first. If the runner is offline, `create_agent` waits and launches when the laptop reconnects.

## Usage log

**Settings** also has a usage view of tool calls made through MCP tokens.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.