Twist MCP サーバー (テスト)
Twistワークスペースと連携するための MCP サーバーです。Twist REST APIを使用して Python で記述されています。現在はテスト目的のみで使用されています。
インストール
前提条件
- Python 3.10以上
- UV パッケージ マネージャー (インストール ガイド)
- Twist APIトークン
- Twist ワークスペース ID
Twist APIトークンの取得
- Twistアカウントにログイン
- Twist アプリコンソールにアクセスしてください
- 個人使用のための新しいアプリケーションを作成する
- OAuth 2 テスト トークンをコピーします。このトークンにより、MCP サーバーは現在ログインしているユーザーにフル スコープ アクセスを許可します。
将来のバージョンでは適切な OAuth 認証が使用されます。
Claude Desktopによる構成
claude_desktop_config.json 内の MCP サーバーのセットに Twist MCP サーバーを追加します。
{
"mcpServers": {
"twist": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/twist-mcp-server",
"run",
"main.py"
],
"env": {
"TWIST_API_TOKEN": "your_twist_api_token",
"TWIST_WORKSPACE_ID": "your_twist_workspace_id"
}
}
}
}
利用可能なツール
現在、次のツールが利用可能です。
- 受信トレイ
twist_inbox_get
: ユーザーの受信トレイの内容を取得するtwist_inbox_archive_all
: ワークスペース内のすべてのスレッド(または、指定されたタイムスタンプ以降のすべてのスレッド)をアーカイブします。twist_inbox_archive
: IDで特定のスレッドをアーカイブするtwist_inbox_unarchive
: IDで特定のスレッドをアーカイブ解除するtwist_inbox_mark_all_read
: 受信トレイのすべてのスレッドを既読としてマークしますtwist_inbox_get_count
: 受信トレイのスレッド数を取得します
- スレッド
twist_threads_getone
: IDでスレッドを取得するtwist_threads_get
: チャネル内のすべてのスレッドを取得するtwist_threads_add
: チャネルに新しいスレッドを追加するtwist_threads_update
: 既存のスレッドを更新するtwist_threads_remove
: スレッドを削除するtwist_threads_star
: スレッドにスターを付けるtwist_threads_unstar
: スレッドのスターを外すtwist_threads_pin
: スレッドをピン留めするtwist_threads_unpin
: スレッドのピンを解除するtwist_threads_move_to_channel
: スレッドを別のチャネルに移動するtwist_threads_get_unread
: ワークスペース内の未読スレッドを取得するtwist_threads_mark_read
: スレッドを既読としてマークするtwist_threads_mark_unread
: スレッドを未読としてマークするtwist_threads_mark_unread_for_others
: スレッドを他のユーザーに対して未読としてマークするtwist_threads_mark_all_read
: ワークスペースまたはチャンネル内のすべてのスレッドを既読としてマークするtwist_threads_clear_unread
: ワークスペース内の未読スレッドをクリアするtwist_threads_mute
: スレッドを一定時間ミュートするtwist_threads_unmute
: スレッドのミュートを解除する
ライセンス
このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。