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" } } } }

Related MCP server: Unstructured API MCP Server

利用可能なツール

現在、次のツールが利用可能です。

受信トレイ
- 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 : スレッドのミュートを解除する