# Connect your coding agent

> Add the ShowTake MCP server to any AI agent. Examples for popular agents below.

Source: https://showtake.app/docs/mcp-setup

The MCP server is the executable `showtake-mcp` inside the app bundle. It speaks MCP over stdio, so every agent that can start a local MCP server can use it. The path is always:

```text
/Applications/ShowTake.app/Contents/MacOS/showtake-mcp
```

## Claude Code

```sh
claude mcp add --scope user showtake -- "/Applications/ShowTake.app/Contents/MacOS/showtake-mcp"
```

`--scope user` makes ShowTake available in every project. Check it with `claude mcp list`.

## Codex

```sh
codex mcp add showtake -- "/Applications/ShowTake.app/Contents/MacOS/showtake-mcp"
```

Or add it to `~/.codex/config.toml` yourself:

```toml
[mcp_servers.showtake]
command = "/Applications/ShowTake.app/Contents/MacOS/showtake-mcp"
```

## Cursor

Add this to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):

```json
{
  "mcpServers": {
    "showtake": {
      "command": "/Applications/ShowTake.app/Contents/MacOS/showtake-mcp",
      "args": []
    }
  }
}
```

## Gemini CLI

```sh
gemini mcp add --scope user showtake "/Applications/ShowTake.app/Contents/MacOS/showtake-mcp"
```

## VS Code

Add this to `.vscode/mcp.json` in your project, or run **MCP: Add Server** from the command palette and choose a stdio server:

```json
{
  "servers": {
    "showtake": {
      "type": "stdio",
      "command": "/Applications/ShowTake.app/Contents/MacOS/showtake-mcp"
    }
  }
}
```

## Other clients

Any client that takes a command for a stdio MCP server works: give it the path above, no arguments, no environment variables.

## The working directory matters

The server looks for Xcode projects in the **working directory of the agent** (`list_targets`). Start your agent in the folder of the app you want to film, or pass `project` to `prepare_ios`.

## What the agent gets

- Tools to prepare, drive and film the app ([tool reference](https://showtake.app/docs/tools)).
- The agent guide as the MCP resource `showtake://guide` and the prompt `film_demo`. Most agents read it on their own; if yours does not, tell it "read the ShowTake guide first".