TaskLite

@tasklite/mcp

AI エージェントが構築したアプリ向けのバックエンドと管理機能です。 tasklite.net · ドキュメント

システムを説明すると、その基盤となるものが手に入ります。型付きのテーブルとリレーション、行、REST エンドポイント、API キー、そしてその後、ビジネス側が運用する管理インターフェースを備えたプロジェクトです。Claude Code、Claude Desktop、ChatGPT、Gemini、Cursor、または VS Code から利用できます。フロントエンドをデプロイし、すべてを引き渡せます。

CLI タスクマネージャーではありません。 TaskLite という名前の、これとは無関係な古いプロジェクトがあります。 ad-si/TaskLite は tasklite.org で公開されているコマンドラインのタスクマネージャーです。これは別の作者による別の製品で、tasklite.net のホステッドバックエンドとして、 @tasklite/mcp および MCP レジストリの net.tasklite/mcp として公開されています。

78 個のツール

ローカルにインストールした場合は 78 個、ホステッドサーバー経由では 73 個です（アカウント関連の 5 つのツール sign_up connect login disconnect connection_status はローカルでのみ利用でき、ホステッド接続では OAuth でサインインします）。各ツールは readOnlyHint、destructiveHint、idempotentHint、openWorldHint を宣言しているため、クライアントはどの操作を無人で安全に実行できるか判断できます。

領域	ツール
アカウント	sign_up connect login disconnect connection_status list_organizations configure_external_access
構造	create_project create_board create_column update_board update_column delete_board delete_column delete_project reorder_columns get_board_schema list_projects list_boards export_project
データ	query_items create_item update_item set_cell get_cells set_cells_if_unchanged delete_item search fetch
コメント	list_comments add_comment update_comment delete_comment
ファイル	request_file_upload list_uploaded_files revoke_upload_link
アプリと API	build_backend create_app publish_app list_apps get_app_spec create_app_endpoint list_app_endpoints update_app_endpoint delete_app_endpoint create_app_api_key configure_app_settings get_email_usage
アプリユーザー、招待、リンク	list_app_users add_app_user set_app_user_role remove_app_user create_app_invite list_app_invites revoke_app_invite check_invite_code link_app_user list_app_user_links unlink_app_user
ロール、ポリシー、履歴	list_app_roles define_app_role delete_app_role grant_app_role revoke_app_role list_app_role_grants get_policy_identity set_policy_identity get_board_policy set_board_policy delete_board_policy explain_access simulate_request get_item_history
フロントエンドホスティング	deploy_frontend list_deployments get_deployment_files rollback_deployment get_frontend_prompt
自動化とプッシュ通知	create_automation update_automation list_automations push_status send_test_push

2 種類のユーザーがいるアプリ

エンドポイントの rowLevelSecurity.mode によって、サインインしたユーザーがアクセスできる行が決まります。owner（自分が作成した行）、shared（許可されたユーザーがすべての行にアクセス）、phone（確認済みの電話番号を持つ行）、または relation（自分を表す行にリレーション列を介してリンクされた行）です。同じ組織内のコーチとその研修生が利用するコーチングアプリは、次の構成で作成します。

ボード	エンドポイントのセキュリティ
Coaches	mode: "phone"、phoneColumn: 電話番号列。各コーチは自分の行を読み取り、編集できます。
Trainees	mode: "relation"、relationColumn: Trainees.Coach、identityPhoneColumn: Coaches.Phone、allowInvites: true。コーチは自分の研修生だけを参照でき、それぞれを自分の行に招待できます。
Weigh-ins (coach)	mode: "relation"、relationColumn: Weigh-ins.Trainee、viaColumn: Trainees.Coach。さらに 1 段階たどり、担当するすべての研修生の計量記録を参照できます。
Weigh-ins (trainee)	同じボード上の 2 つ目のエンドポイント：mode: "relation"、relationColumn: Weigh-ins.Trainee。

ユーザーが行と「同一である」とみなされるのは、招待コード（create_app_invite、またはエンドポイントで allowInvites が有効な場合はアプリ内でコーチが発行したコード）を通じて、link_app_user を通じて、またはリンクがなくても、確認済みの電話番号やメールアドレスが行に記録されている場合（identityPhoneColumn、identityEmailColumn）です。registrationPolicy: "invite" を指定した configure_external_access を使うと、新しいユーザーはコードがある場合にのみ参加できます。rowLevelSecurity で指定できるのはサーバーが読み取るキーのみです。不明なキーは無視されず、拒否されます。

まず利用するのは build_backend です。システムの説明を受け取り、プロジェクト、ボード、リレーションを含む型付き列、サンプル行、キー付きの公開済み REST API を、何度も呼び出すことなく 1 回で作成します。

ロール、ポリシー、履歴

1 つのアプリ内でユーザーごとに異なる情報を参照できるようにする場合（マネージャーはすべての案件を参照でき、エージェントは自分の案件のみ、経理担当者は金額列を参照できます）、エンドポイントで rowLevelSecurity.mode: "policy" を使い、ボードにポリシーを設定します。define_app_role と grant_app_role（または従業員ボードからロールを読み取る set_policy_identity）を使い、次にドキュメントを指定して set_board_policy を実行し、さらに explain_access と simulate_request で動作を検証します。get_item_history は、行のどのフィールドを誰が、どの値からどの値に変更したかを読み取ります。これらのツールには権限ルートを備えたバックエンドが必要です。詳しくはdocs/app-access.mdを参照してください。

セットアップ

パッケージをインストールし（Claude Code がまだない場合はそちらもインストールします）、バイナリを指定してサーバーを追加します。これにより、claude mcp add が npx -y を誤って解析する既知の Windows の問題を回避できます。

npm install -g @anthropic-ai/claude-code @tasklite/mcp
claude mcp add tasklite -- tasklite-mcp

すべてのプロジェクトで利用できるようにするには、claude mcp add に -s user を追加します（claude mcp add -s user tasklite -- tasklite-mcp）。デフォルトでは、現在のプロジェクトでのみ利用できます。

次に、作成したいものを Claude に伝えます。sign_up ツールは会話からアカウント、組織、接続を作成します（強力なランダムパスワードがローカルで生成され、表示されることはありません。ウェブアクセスにはメールアドレスを使って「パスワードをお忘れですか」を利用してください）。

すでにアカウントをお持ちですか？ TaskLite → Integrations →「Connect Claude Code」でキーを作成し、次を使用します。

claude mcp add tasklite -e TASKLITE_API_KEY=tl_xxx -- tasklite-mcp

ホスト型（インストール不要）

任意の MCP クライアントからホスト型サーバーに接続します。ローカルへのインストールは不要です。

claude mcp add --transport http tasklite https://mcp.tasklite.net/mcp \
  --header "Authorization: Bearer tl_xxx"

ホスト型サーバーはステートレスです。各リクエストにそれぞれの認証情報が含まれるため、1 つのエンドポイントであらゆるアカウントに安全に対応できます。

最も簡単な方法：コネクターを使う。 Claude（claude.ai またはデスクトップアプリ）で、Settings → Connectors → TaskLite を追加するか、上記の URL を使ってアドレスを指定して追加します。OAuth で一度サインインすればよく、キーを作成したり保存したりする必要はありません。ツールはすでに開いている会話ではなく、新しいチャットに表示される点にご注意ください。

任意の環境変数：TASKLITE_API_URL（デフォルトは https://api.tasklite.net）、TASKLITE_APP_URL（デフォルトは https://app.tasklite.net）。

その他のクライアント

1 つのホスト型サーバーで、あらゆる MCP クライアントを利用できます。セットアップの詳細：https://tasklite.net/docs/guides/connector-from-cursor-codex-desktop

• Cursor：Cursor に追加するか、.cursor/mcp.json に {"mcpServers":{"tasklite":{"url":"https://mcp.tasklite.net/mcp"}}} を記述します。
• VS Code：VS Code にインストールするか、.vscode/mcp.json に {"servers":{"tasklite":{"type":"http","url":"https://mcp.tasklite.net/mcp"}}} を記述します。
• ChatGPT：設定 → コネクター（開発者モード）→ https://mcp.tasklite.net/mcp を追加します。サーバーは search と fetch を実装しています。
• Gemini CLI：gemini extensions install https://github.com/tasklite-net/tasklite-mcp を実行します（このリポジトリには gemini-extension.json が含まれています）。または、~/.gemini/settings.json に httpUrl と oauth を追加します。
• OpenAI Responses API / Agents SDK、Gemini API：ホスト型 URL を Authorization: Bearer tl_… とともに渡します。

典型的なフロー（Claude Code の動作）

1. create_project → create_board → create_column × N でスキーマを構築します。
2. create_item / query_items でデータを登録して確認します。
3. create_app → create_app_endpoint（exposedColumns + RLS を指定）→ create_app_api_key で、フロントエンド向けに REST インターフェースを公開します。
4. get_app_spec / get_frontend_prompt で、それに対応するフロントエンドを生成します。
5. 各ツールは adminUrl を返します。これはエンドクライアント向けに用意された管理画面です。

フロントエンドのホスティング

deploy_frontend を使うと、静的フロントエンドを https://{slug}.tasklite.dev に配置できます。 サーバーもホスティングアカウントも不要で、CI の設定も必要ありません。次の 3 つの方法のいずれかでサイトを引き渡せます。

deploy_frontend(appId: "app-xxxxxx", files: [{ path: "index.html", content: "<!doctype html>…" }, { path: "app.js", content: "…" }])
deploy_frontend(appId: "app-xxxxxx", zipUrl: "https://github.com/you/site/releases/download/v1/dist.zip")
deploy_frontend(appId: "app-xxxxxx", dir: "./dist")

files は、ChatGPT または任意のホスト型クライアントから渡すパスです。アシスタントはページの作成とデプロイを同じターンで行います。zipUrl には Lovable、Bolt、または GitHub リリースからエクスポートしたファイルを指定します。dir は、ビルド出力のあるマシン上で MCP を実行する場合に使用します。

ホストされたページは、相対パス /api/{endpoint} を介してアプリ API を呼び出します。ホスティングプロキシがサーバー側でアプリの識別情報を付加するため、ブラウザーに API キーが渡ることはありません。list_deployments でバージョンを確認でき、rollback_deployment で公開 URL を以前のバージョンに戻せます。

セキュリティモデル

• tl_ キーは有効期間の短い JWT（POST /public/v1/auth/session）と交換されます。すべての呼び出しはキー所有者自身の権限で実行され、スーパー管理者の権限は使われません。
• アプリ API キーはサーバー側の環境変数（Next.js API ルート）に保存し、ブラウザーのコードには含めないでください。tasklite.dev でホストするフロントエンドにはキーは必要ありません。

開発

npm install
npm run build
TASKLITE_API_KEY=tl_xxx TASKLITE_API_URL=http://localhost:3333 node dist/index.js

ライセンス

MIT