Biarkan AI agent mengelola project, ticket, space, dan chat di Teamwork.com melalui Model Context Protocol.
Juga dikenal sebagai teamwork/mcp, mcp
- Stars
- 28
- Tools
- โ
- Unduhan, 30 hari
- โ
- Versi terbaru
- 1.62.2
- Commit terakhir
- 15 Nov 2026
- Lisensi
- MIT
Apa itu Teamwork.com MCP?
Teamwork.com adalah MCP server. Biarkan AI agent mengelola project, ticket, space, dan chat di Teamwork.com melalui Model Context Protocol.
Ringkasan dibuat dari README proyek
Tentang Teamwork.com MCP server
Mengelola project, ticket, dan komunikasi Teamwork.com melalui AI agent kini dimungkinkan dengan integrasi ini. Tool ini menyediakan cara standar bagi large language model untuk berinteraksi dengan workflow Anda yang sudah ada dengan menyediakan tool untuk Projects, Desk, Spaces, dan Chat. Developer dapat menggunakannya untuk mengotomatisasi tugas seperti mengelola task, tag, timer, atau customer ticket langsung dari AI client.
User dapat men-deploy server ini menggunakan interface HTTP untuk lingkungan cloud atau interface stdio untuk aplikasi desktop lokal. Autentikasi ditangani melalui bearer token atau OAuth2, dan sistem mendukung mode read-only opsional untuk memastikan keamanan selama operasi berlangsung. Server ini dibangun dengan Go dan memerlukan versi 1.27 atau yang lebih baru untuk dijalankan.
Toolset ini dirancang untuk berbagai kebutuhan deployment, menawarkan HTTP server yang siap untuk produksi guna mendukung multi-client serta tool command-line untuk testing dan debugging. Tool ini mencakup berbagai domain internal termasuk twprojects, twdesk, twspaces, dan twchat untuk memastikan cakupan yang komprehensif pada platform Teamwork.com.
Apa yang bisa Anda lakukan dengannya
- 1Otomatisasi tugas manajemen proyekAI agent dapat mengelola berbagai operasi proyek termasuk task, tag, dan timer.
- 2Menangani ticket customer supportDeveloper dapat menggunakan tool Desk untuk mengelola interaksi dan ticket pelanggan.
- 3Testing fungsionalitas server secara amanDeveloper dapat menggunakan tool CLI yang tersedia untuk melakukan debug dan testing pada MCP server via HTTP.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Teamwork.com MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Teamwork.com MCP di Claude Code
$ claude mcp add --env 'TW_MCP_BEARER_TOKEN=<YOUR_TW_MCP_BEARER_TOKEN>' mcp -- docker run -i --rm docker.io/teamwork/mcp:v1.62.2Instal Teamwork.com MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/teamwork/mcp:v1.62.2"
],
"env": {
"TW_MCP_BEARER_TOKEN": "<YOUR_TW_MCP_BEARER_TOKEN>"
}
}
}
}Instal Teamwork.com MCP di VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/teamwork/mcp:v1.62.2"
],
"env": {
"TW_MCP_BEARER_TOKEN": "<YOUR_TW_MCP_BEARER_TOKEN>"
}
}
}
}Instal Teamwork.com MCP di VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"docker","args":["run","-i","--rm","docker.io/teamwork/mcp:v1.62.2"],"env":{"TW_MCP_BEARER_TOKEN":"<YOUR_TW_MCP_BEARER_TOKEN>"}}'Instal Teamwork.com MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/teamwork/mcp:v1.62.2"
],
"env": {
"TW_MCP_BEARER_TOKEN": "<YOUR_TW_MCP_BEARER_TOKEN>"
}
}
}
}Instal Teamwork.com MCP di Codex
$ codex mcp add mcp --env 'TW_MCP_BEARER_TOKEN=<YOUR_TW_MCP_BEARER_TOKEN>' -- docker run -i --rm docker.io/teamwork/mcp:v1.62.2Instal Teamwork.com MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "docker" args = ["run", "-i", "--rm", "docker.io/teamwork/mcp:v1.62.2"] [mcp_servers.mcp.env] TW_MCP_BEARER_TOKEN = "<YOUR_TW_MCP_BEARER_TOKEN>"
Instal Teamwork.com MCP di Gemini CLI
$ gemini mcp add -s user -e 'TW_MCP_BEARER_TOKEN=<YOUR_TW_MCP_BEARER_TOKEN>' mcp docker -- run -i --rm docker.io/teamwork/mcp:v1.62.2Instal Teamwork.com MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/teamwork/mcp:v1.62.2"
],
"env": {
"TW_MCP_BEARER_TOKEN": "<YOUR_TW_MCP_BEARER_TOKEN>"
}
}
}
}Konfigurasi
TW_MCP_BEARER_TOKENWajibRahasiaAPI key generated from the Teamwork.com OAuth2 process: https://apidocs.teamwork.com/guides/teamwork/app-login-flow
NODE_EXTRA_CA_CERTSTW_MCP_LOG_FORMATChoose log output format between 'text' or 'json'. Default is 'text'.
TW_MCP_LOG_LEVELChoose log level between 'debug', 'info', 'warn' or 'error'. Default is 'info'.
TW_MCP_SERVER_ADDRESS
| Nama | Deskripsi | Tipe |
|---|---|---|
| TW_MCP_BEARER_TOKEN | API key generated from the Teamwork.com OAuth2 process: https://apidocs.teamwork.com/guides/teamwork/app-login-flow | WajibRahasia |
| NODE_EXTRA_CA_CERTS | โ | |
| TW_MCP_LOG_FORMAT | Choose log output format between 'text' or 'json'. Default is 'text'. | |
| TW_MCP_LOG_LEVEL | Choose log level between 'debug', 'info', 'warn' or 'error'. Default is 'info'. | |
| TW_MCP_SERVER_ADDRESS | โ |
Pengecekan otomatis
Berjalan 12 Nov 2026Laporan lengkap โLolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauLolos
- Lisensi open source (OSI)Lolos
- Ada commit atau release dalam satu tahun terakhirLolos
- Nama package tidak mirip dengan package populerTidak diperiksa
- Remote endpoint menggunakan HTTPSLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Tidak ada instruksi tersembunyi untuk modelLolos
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
README
Lihat di GitHubTeamwork MCP Server
Model Context Protocol server for Teamwork.com integration with Large Language Models
๐ Are you a Teamwork.com user wanting to connect AI tools to your Teamwork.com site right now? Jump straight to the Usage Guide for tokens, enabling MCP, and client configuration examples.
๐ Overview
This MCP (Model Context Protocol) server enables seamless integration between Large Language Models and Teamwork.com. It provides a standardized interface for LLMs to interact with Teamwork.com projects, allowing AI agents to perform various project management operations.
๐ค What is MCP?
Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to LLMs. This server describes all the actions available in Teamwork.com (tools) in a way that LLMs can understand and execute through AI agents.
โจ Features
- Multiple Transport Modes: HTTP and STDIO interfaces for different deployment scenarios
- Secure Authentication: Bearer token and OAuth2 integration with Teamwork.com
- Tool Framework: Extensible toolset architecture for adding new capabilities
- Production Ready: Comprehensive logging, monitoring, and observability
- Read-Only Mode: Optional restriction to read-only operations for safety
See the auto-generated Tool Reference for every create/read/update operation exposed across Projects, Desk, Spaces, and Chat, or browse the same catalogue with per-tool descriptions and a search filter at teamwork.github.io/mcp.
๐ Available Servers
This project provides three different ways to interact with the Teamwork.com MCP server:
๐ก HTTP Server
Production-ready HTTP server for cloud deployments and multi-client support.
๐ Full HTTP Server Documentation
Quick start:
TW_MCP_SERVER_ADDRESS=:8080 go run cmd/mcp-http/main.go
๐ฌ STDIO Server
Direct STDIO interface for desktop applications and development environments.
๐ Full STDIO Server Documentation
Quick start:
TW_MCP_BEARER_TOKEN=your-token go run cmd/mcp-stdio/main.go
๐ ๏ธ HTTP CLI
Command-line tool for testing and debugging MCP server functionality.
๐ Full HTTP CLI Documentation
Quick start:
go run cmd/mcp-http-cli/main.go -mcp-url=https://mcp.example.com list-tools
๐ Prerequisites
- Go 1.27 or later
- Valid Teamwork.com API credentials (bearer token or OAuth2 setup)
๐งช Development & Testing
Running Tests
# Run all tests
go test ./...
# Run specific package tests
go test ./internal/twprojects/
MCP Inspector
For debugging purposes, use the MCP Inspector tool:
NODE_EXTRA_CA_CERTS=letsencrypt-stg-root-x1.pem npx @modelcontextprotocol/inspector node build/index.js
[!IMPORTANT] Note: The
NODE_EXTRA_CA_CERTSenvironment variable is required when using OAuth2 authentication with the Let's Encrypt certification authority. Download the certificate here.
๐๏ธ Architecture
โโโ cmd/
โ โโโ mcp-http/ # HTTP server implementation
โ โโโ mcp-stdio/ # STDIO server implementation
โ โโโ mcp-http-cli/ # CLI tool for testing via HTTP
โ โโโ mcp-test/ # Walks tool handlers against a real site
โ โโโ mcp-tokens/ # Token-cost report for the tool surface
โ โโโ docs-gen/ # Generates the tool reference (Markdown + GitHub Pages)
โโโ pkg/ # Importable by other MCP servers built on this one
โ โโโ auth/ # Authentication helpers (bearer & OAuth2 token handling)
โ โโโ cli/ # -toolsets flag parsing
โ โโโ config/ # Configuration management (env, flags), MCP server setup
โ โโโ helpers/ # Shared utility functions (errors, link helpers, tool parsing)
โ โโโ request/ # HTTP request primitives / Teamwork API wiring
โ โโโ testutil/ # Product-neutral test mocks
โ โโโ toolsets/ # Tool framework and registration logic
โ โโโ twctx/ # Per-request values derived from the bearer token
โโโ internal/ # This server's own tools, not importable elsewhere
โ โโโ twprojects/ # Teamwork project/domain tools (tasks, tags, timers, etc.)
โ โโโ twdesk/ # Teamwork Desk tools (tickets, customers, etc.)
โ โโโ twspaces/ # Teamwork Spaces tools (spaces, pages, etc.)
โ โโโ twchat/ # Teamwork Chat tools (conversations, messages)
โโโ examples/ # Usage & integration examples (LangChain Node/Python)
โโโ docs/usage/ # End-user setup & connection guide
โโโ Makefile # Common developer tasks
โโโ Dockerfile # Container build configuration
โโโ CODE_OF_CONDUCT.md # Community guidelines
โโโ CONTRIBUTING.md # Contribution guide
โโโ SECURITY.md # Security policy
Pertanyaan tentang Teamwork.com MCP
Bagaimana cara menambahkan Teamwork.com MCP ke Claude Code?
Jalankan claude mcp add --env 'TW_MCP_BEARER_TOKEN=<YOUR_TW_MCP_BEARER_TOKEN>' mcp -- docker run -i --rm docker.io/teamwork/mcp:v1.62.2 di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Teamwork.com MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apa yang bisa dilakukan oleh Teamwork.com MCP server?
Server ini menyediakan operasi create/read/update di Teamwork.com untuk Projects, Desk, Spaces, dan Chat sehingga AI agent dapat menjalankan tugas manajemen proyek.
Bagaimana cara melakukan autentikasi pada Teamwork.com MCP server?
Server ini mendukung integrasi bearer token atau OAuth2 dengan Teamwork.com.
Mode transport apa saja yang didukung oleh Teamwork.com MCP server?
Tersedia interface HTTP dan stdio untuk berbagai skenario deployment, serta HTTP CLI untuk keperluan testing.
Bisakah saya membatasi Teamwork.com MCP server hanya untuk operasi read-only?
Ya, tersedia mode read-only opsional yang membatasi server hanya untuk operasi baca demi keamanan.
Apa saja prasyarat untuk menjalankan Teamwork.com MCP server?
Anda memerlukan Go 1.27 atau versi terbaru serta kredensial API Teamwork.com yang valid, baik berupa bearer token maupun setup OAuth2.