notis-mcp

Notis MCP

現在のエージェントがホスト型 Notis MCP に接続されており、シェルまたは Notis CLI を利用できない場合は、このガイドを使用してください。

基本的なワークフロー

1. 接続済みまたは接続可能なインテグレーションを確認する必要がある場合は、notis_list_toolkits を呼び出してください。
2. タスク全体を具体的に説明して、notis_search_tools を呼び出してください。返された対象ツール名をそのまま使用してください。
3. 結果に required_resource_uri が含まれている場合は、対象の呼び出しを組み立てる前に、その MCP リソースを読み取ってください。クライアントが MCP リソースを読み取れない場合は、同じ URI を指定して notis_fetch を呼び出してください。
4. 検索結果が曖昧な場合、または最新の完全な JSON Schema が必要な場合は、notis_describe_tools を呼び出してください。
5. 実行前に notis_validate_calls を呼び出してください。
6. read レーンに分類された対象ツールに対してのみ notis_execute_read を使用してください。write レーンに分類された対象ツールに対してのみ notis_execute_write を使用してください。
7. 書き込み呼び出しごとに、安定した idempotency_key を指定してください。同じ意図の変更を再試行する場合に限り、まったく同じキーを再利用してください。

Notis はサーバー側で作用を分類します。対象ツールの名前から読み取り専用だと推測してはいけません。

スキルに基づく操作ガイド

Notis は、複雑な操作契約を notis://docs/* MCP リソースとして公開しています。内容は正規の Notis スキルから直接生成されるため、所有するスキルが変更されるたびにリソースも更新されます。

特に重要なガイドは次のとおりです。

• 構造化されたネイティブデータベースクエリと、生成されるデータベースのアップサートについては notis://docs/notis-query
• リマインダーおよび自動化の変更については notis://docs/notis-automation
• Store アプリの明示的なインストールについては notis://docs/notis-spaces
• 汎用 MCP ワークフローとローカル CLI ワークフローの比較については notis://docs/notis-cli

どのガイドが該当するか推測するのではなく、選択したツールとともに返された URI を優先してください。

接続

必要なクラウドツールキットが接続されていない場合は、notis_connect_toolkit を呼び出してください。認証 URL をユーザーに提示し、プロバイダーの手続きが完了するまで待ってから、検出を再試行してください。

ローカルのデスクトップ MCP サーバー、認証情報、シェルツール、デスクトップコントロールは、ホスト型 MCP では設定できません。Local MCP を含む Your Computer バンドル全体は、Free を含むすべてのプランで利用できます。ローカル対応のエージェント環境から使用する前に、Notis Desktop で設定してください。

安全上の境界

• すべての変更を実行前に検証してください。
• 対象ツール名や引数を捏造しないでください。
• 対象ツールが明示的にシークレットを要求する場合を除き、検索クエリやツール引数にシークレットを含めないでください。
• 返されたカーソルと識別子は不透明な値として扱ってください。
• サーバーから返された実行レーンとクラウド対応状況を遵守してください。
• ローカルアプリのソース／ビルド／デプロイコマンド、ローカルファイル、ローカルシェル、デバッグ用オーバーライド、認証情報の取得は、ホスト型 MCP では意図的に利用できません。ネイティブの Store およびアプリ管理ツールは、サーバーから返されたサーフェスと PostHog の可視性ポリシーに従います。
• スキルの管理は、Free を含むすべてのプランで利用できます。個別の厳選スキルでは、追加の有料利用権が設定されている場合があります。その場合、インストールまたは実行時に、正式なアップグレード必須の結果が返されます。