Teamwork.com

Teamwork MCP サーバー

Teamwork.com と大規模言語モデルの統合のための Model Context Protocol サーバー

📌 今すぐ AI ツールを Teamwork.com サイトに接続したい Teamwork.com ユーザーですか？トークン、MCP の有効化、クライアント設定の例については、利用ガイド に直接お進みください。

📖 概要

この MCP（Model Context Protocol）サーバーは、大規模言語モデルと Teamwork.com のシームレスな統合を可能にします。LLM が Teamwork.com のプロジェクトとやり取りするための標準化されたインターフェースを提供し、AI エージェントがさまざまなプロジェクト管理操作を実行できるようにします。

🤖 MCP とは？

Model Context Protocol（MCP）は、アプリケーションが LLM にコンテキストを提供する方法を標準化するオープンプロトコルです。このサーバーは、Teamwork.com で利用可能なすべてのアクション（ツール）を、LLM が理解し AI エージェントを通じて実行できる形で記述します。

✨ 機能

• 複数のトランスポートモード: さまざまなデプロイシナリオに対応する HTTP および STDIO インターフェース
• 安全な認証: Teamwork.com との Bearer トークンおよび OAuth2 統合
• ツールフレームワーク: 新しい機能を追加するための拡張可能なツールセットアーキテクチャ
• 本番環境対応: 包括的なロギング、モニタリング、可観測性
• 読み取り専用モード: 安全性のための読み取り専用操作へのオプションの制限

Projects、Desk、Spaces、Chat 全体で公開されているすべての作成/読み取り/更新操作については、自動生成された ツールリファレンス を参照するか、teamwork.github.io/mcp でツールごとの説明と検索フィルターを備えた同じカタログを閲覧してください。

🚀 利用可能なサーバー

このプロジェクトは、Teamwork.com MCP サーバーとやり取りする 3 つの異なる方法を提供します。

📡 HTTP サーバー

クラウドデプロイとマルチクライアントサポートのための本番環境対応 HTTP サーバー。

📖 HTTP サーバー完全ドキュメント

クイックスタート:

TW_MCP_SERVER_ADDRESS=:8080 go run cmd/mcp-http/main.go

💬 STDIO サーバー

デスクトップアプリケーションと開発環境のための直接 STDIO インターフェース。

📖 STDIO サーバー完全ドキュメント

クイックスタート:

TW_MCP_BEARER_TOKEN=your-token go run cmd/mcp-stdio/main.go

🛠️ HTTP CLI

MCP サーバー機能のテストとデバッグのためのコマンドラインツール。

📖 HTTP CLI 完全ドキュメント

クイックスタート:

go run cmd/mcp-http-cli/main.go -mcp-url=https://mcp.example.com list-tools

📋 前提条件

• Go 1.27 以降
• 有効な Teamwork.com API 認証情報（Bearer トークンまたは OAuth2 の設定）

🧪 開発とテスト

テストの実行

# Run all tests
go test ./...

# Run specific package tests
go test ./internal/twprojects/

MCP Inspector

デバッグの目的には、MCP Inspector ツールを使用してください:

NODE_EXTRA_CA_CERTS=letsencrypt-stg-root-x1.pem npx @modelcontextprotocol/inspector node build/index.js

重要

注意: NODE_EXTRA_CA_CERTS 環境変数は、Let's Encrypt 証明機関で OAuth2 認証を使用する場合に必要です。 証明書はこちらからダウンロードしてください。

🏗️ アーキテクチャ

├── 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