ComposioHQ/habitica-automation

Rube MCP 経由の Habitica 自動化

Composio の Habitica ツールキットを Rube MCP 経由で使用して、Habitica の操作を自動化します。

ツールキットドキュメント: composio.dev/toolkits/habitica

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能であること）
• RUBE_MANAGE_CONNECTIONS でツールキット habitica を使用した有効な Habitica 接続があること
• 最初に必ず RUBE_SEARCH_TOOLS を呼び出して、現在のツールスキーマを取得すること

セットアップ

Rube MCP の取得: クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要で、エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確認する
2. ツールキット habitica を指定して RUBE_MANAGE_CONNECTIONS を呼び出す
3. 接続が ACTIVE でない場合は、返された認証リンクに従ってセットアップを完了する
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認する

ツール発見

ワークフローを実行する前に、常に利用可能なツールを発見します。

RUBE_SEARCH_TOOLS
queries: [{use_case: "Habitica operations", known_fields: ""}]
session: {generate_id: true}

これにより、利用可能なツールスラッグ、入力スキーマ、推奨実行計画、既知の落とし穴が返されます。

コアワークフローパターン

ステップ 1: 利用可能なツールを発見する

RUBE_SEARCH_TOOLS
queries: [{use_case: "your specific Habitica task"}]
session: {id: "existing_session_id"}

ステップ 2: 接続を確認する

RUBE_MANAGE_CONNECTIONS
toolkits: ["habitica"]
session_id: "your_session_id"

ステップ 3: ツールを実行する

RUBE_MULTI_EXECUTE_TOOL
tools: [{
  tool_slug: "TOOL_SLUG_FROM_SEARCH",
  arguments: {/* 検索結果からスキーマに準拠した引数 */}
}]
memory: {}
session_id: "your_session_id"

既知の落とし穴

• 常に最初に検索すること: ツールスキーマは変更されます。RUBE_SEARCH_TOOLS を呼び出さずにツールスラッグや引数をハードコードしないでください。
• 接続を確認すること: ツールを実行する前に RUBE_MANAGE_CONNECTIONS が ACTIVE ステータスを示していることを確認してください。
• スキーマに準拠すること: 検索結果から正確なフィールド名と型を使用してください。
• メモリパラメータ: RUBE_MULTI_EXECUTE_TOOL の呼び出しには、空の場合（{}）でも常に memory を含めてください。
• セッションの再利用: 同一ワークフロー内ではセッション ID を再利用してください。新しいワークフローには新しい ID を生成してください。
• ページネーション: 応答にページネーショントークンがないか確認し、完了するまでデータを取得し続けてください。

クイックリファレンス

操作	方法
ツール検索	RUBE_SEARCH_TOOLS（Habitica 固有のユースケースを指定）
接続	RUBE_MANAGE_CONNECTIONS（ツールキット habitica を指定）
実行	RUBE_MULTI_EXECUTE_TOOL（発見したツールスラッグを使用）
一括操作	RUBE_REMOTE_WORKBENCH（run_composio_tool() を使用）
完全スキーマ	RUBE_GET_TOOL_SCHEMAS（schemaRef を持つツール用）

---

Powered by Composio