# mcp

Официальный MCP-сервер Teamwork.com: агент читает проекты, задачи и тикеты и меняет их по твоей команде. Пригодится, если работа с задачами идёт мимо IDE.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 27
- Автор: Teamwork
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Teamwork/mcp
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/teamwork-mcp

## Что делает

Сервер описывает действия Teamwork.com так, чтобы агент понимал их и вызывал сам: проекты, задачи, теги, таймеры, тикеты Desk, страницы Spaces, переписку Chat. Подключение идёт либо к удалённому адресу `https://mcp.ai.teamwork.com/sse`, либо к локальному контейнеру `docker.io/teamwork/mcp:v1.51.3` по stdio.

Внутри проект на Go: HTTP-сервер для нескольких клиентов, stdio-сервер для десктопных клиентов и CLI для отладки, которым можно запросить список инструментов. Авторизация — bearer-токен Teamwork.com или OAuth2. Отдельно включается режим только для чтения: он отсекает операции записи, и это разумная настройка на время, пока не понятно, как агент обращается с живым проектом.

Сборка из исходников требует Go 1.27 или новее. Без `TW_MCP_BEARER_TOKEN` в окружении контейнер запустится, но к API не пройдёт. Если OAuth2 работает через удостоверяющий центр Let's Encrypt, отладка в MCP Inspector без `NODE_EXTRA_CA_CERTS` упадёт на проверке сертификата.

## Требования
- Нужно: Docker
- Удалённый сервер: `https://mcp.ai.teamwork.com/sse`
- Переменные окружения: `TW_MCP_BEARER_TOKEN`, `TW_MCP_LOG_FORMAT`, `TW_MCP_LOG_LEVEL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http teamwork-mcp https://mcp.ai.teamwork.com/sse
```

2. **Командой платформы**
```bash
claude mcp add --env TW_MCP_BEARER_TOKEN=<TW_MCP_BEARER_TOKEN> --env TW_MCP_LOG_FORMAT=<TW_MCP_LOG_FORMAT> --env TW_MCP_LOG_LEVEL=<TW_MCP_LOG_LEVEL> --transport stdio teamwork-mcp -- docker run -i --rm -e TW_MCP_BEARER_TOKEN -e TW_MCP_LOG_FORMAT -e TW_MCP_LOG_LEVEL docker.io/teamwork/mcp:v1.51.3
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add teamwork-mcp --url https://mcp.ai.teamwork.com/sse
```

2. **Командой платформы**
```bash
codex mcp add teamwork-mcp --env TW_MCP_BEARER_TOKEN=<TW_MCP_BEARER_TOKEN> --env TW_MCP_LOG_FORMAT=<TW_MCP_LOG_FORMAT> --env TW_MCP_LOG_LEVEL=<TW_MCP_LOG_LEVEL> -- docker run -i --rm -e TW_MCP_BEARER_TOKEN -e TW_MCP_LOG_FORMAT -e TW_MCP_LOG_LEVEL docker.io/teamwork/mcp:v1.51.3
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "teamwork-mcp": {
            "url": "https://mcp.ai.teamwork.com/sse"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "teamwork-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "TW_MCP_BEARER_TOKEN",
                "-e",
                "TW_MCP_LOG_FORMAT",
                "-e",
                "TW_MCP_LOG_LEVEL",
                "docker.io/teamwork/mcp:v1.51.3"
            ],
            "env": {
                "TW_MCP_BEARER_TOKEN": "<TW_MCP_BEARER_TOKEN>",
                "TW_MCP_LOG_FORMAT": "<TW_MCP_LOG_FORMAT>",
                "TW_MCP_LOG_LEVEL": "<TW_MCP_LOG_LEVEL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "teamwork-mcp": {
            "type": "http",
            "url": "https://mcp.ai.teamwork.com/sse"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "teamwork-mcp": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "TW_MCP_BEARER_TOKEN",
                "-e",
                "TW_MCP_LOG_FORMAT",
                "-e",
                "TW_MCP_LOG_LEVEL",
                "docker.io/teamwork/mcp:v1.51.3"
            ],
            "env": {
                "TW_MCP_BEARER_TOKEN": "<TW_MCP_BEARER_TOKEN>",
                "TW_MCP_LOG_FORMAT": "<TW_MCP_LOG_FORMAT>",
                "TW_MCP_LOG_LEVEL": "<TW_MCP_LOG_LEVEL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http teamwork-mcp https://mcp.ai.teamwork.com/sse
```

2. **Командой платформы**
```bash
gemini mcp add -e TW_MCP_BEARER_TOKEN=<TW_MCP_BEARER_TOKEN> -e TW_MCP_LOG_FORMAT=<TW_MCP_LOG_FORMAT> -e TW_MCP_LOG_LEVEL=<TW_MCP_LOG_LEVEL> teamwork-mcp docker run -i --rm -e TW_MCP_BEARER_TOKEN -e TW_MCP_LOG_FORMAT -e TW_MCP_LOG_LEVEL docker.io/teamwork/mcp:v1.51.3
```
Вместо <…> подставьте свои значения

## Когда брать
- собрать список задач проекта вместе с тегами и запущенными таймерами
- разобрать очередь тикетов в Teamwork Desk
- найти нужную страницу в Teamwork Spaces по названию
- прочитать переписку в Teamwork Chat и вытащить из неё решения
- создать задачу из обсуждения, не открывая браузер

## Примеры запросов агенту
- Покажи мои задачи в Teamwork на эту неделю
- Создай задачу в проекте «Редизайн», срок — пятница
- Открой тикеты в Teamwork Desk, на которые ещё не ответили

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md