Awaken Tax

Cursor 向け Awaken

OAuth を通じて Cursor を Awaken の暗号資産税務ワークスペースに接続します。プラグインをインストールして Awaken にサインインし、同意ページでワークスペースとアクセスレベルを選択してください。

このプラグインには、ホスト型 MCP 接続 https://mcp.awaken.tax/mcp と、トランザクションの確認、取得価額の不足調査、レポート作成に使える Awaken 公開の awaken スキルが含まれています。MCP 接続の利用にローカルサーバーやランタイムは必要ありません。

同梱のスキルは、api.awaken.tax/skill の公開版（バージョン 1.0.1）と、付属の cookbook.md の変更されていないコピーです。このスキルは接続済みの MCP ツールを優先し、別途直接 API を使うワークフローについても説明しています。公開スキルを更新する際は、同梱ファイルの両方を一緒に更新してください。

接続

1. マーケットプレイスの掲載が開始されたら、Cursor のカスタマイズページから Awaken をインストールします。
2. awaken MCP サーバーを有効にし、Cursor で認証フローを開始します。
3. ブラウザーで Awaken にサインインし、接続するワークスペースを選択します。
4. アクセスを要求しているアプリを確認し、読み取りアクセスを許可または読み取り＋書き込みを許可を選択してから、Cursor に戻ります。
5. 新しいエージェントチャットを開始し、利用可能な Awaken ツールを一覧表示して、読み取り操作でアクセスを確認するよう依頼します。

Awaken は同意時とトークン使用時に、ワークスペースのメンバーシップと Connected Apps の利用資格を確認します。ワークスペースを利用できない場合は、利用資格のあるワークスペースを選択してください。MCP 接続に API キーや、Awaken のクライアント ID の手動入力は必要ありません。プラグインの MCP 接続で API キーを使う方法は、後のバージョンでの対応に延期されています。

このプラグインは、同意ページで両方のアクセスレベルを選択できるように、read と write を要求します。読み取り専用アクセスを許可してもかまいません。書き込みツールが検出結果に表示される場合もありますが、ツールの実行時には、実際に許可したスコープが Awaken によって適用されます。

試す

/awaken を呼び出すか、Cursor に次のように依頼します。

• 「2025 年の課税対象イベントのうち金額の大きいものを確認し、取得価額が不足しているものを知らせてください。」
• 「未確認のトランザクションを探し、編集する前に提案するラベルを説明してください。」
• 「2025 年の Form 8949 を作成し、準備ができたらダウンロードリンクを教えてください。」

編集には、書き込みアクセスの許可と、依頼された変更に対する認可が必要です。レポートを利用できるかどうかは、ワークスペースとサーバーのツールによって異なります。

再接続または切断

OAuth トークンと更新は Cursor が管理します。接続の有効期限が切れた場合や認証に失敗した場合は、Cursor から awaken サーバーに再接続し、もう一度同意手続きを完了してください。読み取り専用アクセスが原因で書き込み操作がブロックされた場合は、Cursor のスコープ承認フローに従うか、再接続して読み取り＋書き込みを許可してください。

アクセスを取り消すには、Awaken の設定にある Connected Apps から Cursor を切断します。Cursor でサーバーを無効にすると、Cursor での使用が停止します。Awaken で許可を取り消すと、認証が無効になります。

OAuth 設定

MCP の設定では、Cursor の公開 OAuth ID を使用します。

{
  "mcpServers": {
    "awaken": {
      "url": "https://mcp.awaken.tax/mcp",
      "auth": {
        "CLIENT_ID": "https://cursor.com/oauth/mcp-client.json",
        "scopes": ["read", "write"]
      }
    }
  }
}

CLIENT_ID は Cursor アプリケーションを識別するものであり、Awaken のワークスペース ID ではありません。クライアントシークレットはありません。Cursor は PKCE を使用した認可コードフローを実行し、Awaken が公開している次のディスカバリーエンドポイントを使用します。

• 保護されたリソース
• 認可サーバー
• Cursor クライアントのメタデータ

Awaken はこの Cursor メタデータ ID を認識し、公開されているコールバックを検証します。S256 PKCE を使用した認可コードグラントとリフレッシュトークングラントをサポートしていますが、動的クライアント登録は公開していません。公開クライアント ID を明示的に設定しても、既存のフローが使用されます。Cursor の OAuth 設定を参照してください。

トラブルシューティング

• プラグインが見つからない： マニフェストの場所、ローカルインポートポリシー、競合するマーケットプレイスからのインストールを確認し、Cursor を再読み込みしてください。
• ログインプロンプトが表示されない、または invalid_client が表示される： 同梱されている auth.CLIENT_ID がそのままであることと、インストール済みの Cursor のバージョンがリモート OAuth に対応していることを確認してください。Awaken は認識済みの Cursor メタデータ ID を受け入れます。任意の登録済みクライアント ID はサポートされていません。
• ワークスペースを利用できない： Awaken はワークスペースへの直接的な所属と Connected Apps の利用資格を確認します。利用資格のある目的のワークスペースを使用してください。
• 編集が拒否される： OAuth の同意を通じて書き込みアクセスを承認してください。ツールが表示されているだけでは、書き込みアクセスは許可されません。
• レポートの準備中： エクスポートを重複して開始するのではなく、ステータス確認／取得ツールを使用してください。Awaken のレポートを参照してください。

データアクセス

このパッケージは Awaken のホスト型 MCP サービスに直接接続します。OAuth アクセスは、選択したワークスペースと承認済みのスコープに紐付けられます。ツールの引数は Awaken に送信され、返されたデータは Cursor のエージェントから利用できます。このパッケージは、分析機能やローカル実行可能フックを追加しません。OAuth 認証情報は標準の MCP エンドポイントに適用されるものであり、GraphQL やその他の Awaken API サーフェスで使用してはなりません。

サービスの詳細については、Awaken のドキュメントを参照してください。

Gemini CLI

このリポジトリは Gemini CLI 拡張機能でもあります（gemini-extension.json）。

gemini extensions install https://github.com/awakentax/plugin

Gemini CLI は Awaken MCP トークンを要求します。これは、Awaken の Settings → API Keys に表示されるポートフォリオ ID と API キーをコロン（<portfolioId>:<apiKey>）で連結したものです。API キーの利用には Dolphin または Whale プランが必要です。Gemini CLI は OAuth ではなく、API キーで接続します。

MCP Registry

server.json は、公式 MCP Registry に登録された Awaken のエントリー tax.awaken/awaken です。awaken.tax ドメインキーでサインインした後、mcp-publisher publish で変更を公開してください。

ライセンス

プラグインのコードと説明は MIT ライセンスで提供されています。詳しくは LICENSE を参照してください。Awaken のロゴは Awaken のブランドアセットであり、コードライセンスの対象外です。ロゴのソースは https://awaken.tax/docs/awaken-word.svg です。