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. 开始新的 Agent 聊天，让它列出可用的 Awaken 工具，并通过读取操作验证访问权限。

Awaken 会在授权和令牌使用期间检查工作区成员资格及 Connected Apps 使用资格。如果工作区不可用，请选择符合条件的工作区。使用 MCP 连接无需 API 密钥，也无需手动输入 Awaken 客户端 ID。插件 MCP 连接的 API 密钥选项将推迟到后续版本。

插件会请求 read 和 write 权限，以便授权页面提供这两种访问级别。你可以批准只读访问。即使写入工具仍会显示在发现结果中，Awaken 也会在工具运行时强制执行你实际批准的权限范围。

试用

调用 /awaken，或向 Cursor 提问：

• “审核我在 2025 年金额最大的应税事件，并标记缺失成本基础的项目。”
• “查找我尚未审核的交易，并在编辑前说明建议使用的标签。”
• “生成我 2025 年的 Form 8949，准备好后提供下载链接。”

编辑需要已批准的写入权限，以及对所请求更改的授权。报告是否可用取决于你的工作区和服务提供的工具。

重新连接或断开连接

Cursor 会管理 OAuth 令牌及其刷新。如果连接过期或身份验证失败，请通过 Cursor 重新连接 awaken 服务，并再次完成授权。如果只读访问导致写入操作被阻止，请按照 Cursor 的权限范围审批流程操作，或重新连接并批准读取和写入权限。

若要撤销访问权限，请在 Awaken 设置的 Connected Apps 中断开 Cursor。停用 Cursor 中的服务会停止在 Cursor 中使用该服务；在 Awaken 中撤销授权则会使授权失效。

OAuth 配置

MCP 配置使用 Cursor 的公开 OAuth 身份：

{
  "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 元数据身份，并验证其公布的回调地址。它支持带有 S256 PKCE 的授权码和刷新令牌授权；不提供动态客户端注册。明确设置公开客户端身份会使用该现有流程。请参阅 Cursor 的 OAuth 配置。

故障排除

• **插件缺失：**检查清单文件位置、本地导入策略、是否从其他市场安装了竞争插件，并重新加载 Cursor。
• **没有登录提示或出现 invalid_client：**检查随附的 auth.CLIENT_ID 是否完好，以及已安装的 Cursor 版本是否支持远程 OAuth。Awaken 接受已识别的 Cursor 元数据身份；不支持任意注册的客户端 ID。
• **工作区不可用：**Awaken 会检查直接工作区成员资格和 Connected Apps 资格。请使用符合条件的目标工作区。
• **编辑遭拒：**通过 OAuth 授权同意批准写入权限；仅能看到工具并不代表拥有写入权限。
• **报告正在准备：**请使用状态／检索工具，而不是重复启动导出。请参阅 Awaken 报告。

数据访问

此软件包直接连接到 Awaken 托管的 MCP 服务。OAuth 访问权限与所选工作区及已批准的权限范围绑定。工具参数会发送给 Awaken；返回的数据可供 Cursor 的 Agent 使用。此软件包不会添加分析功能或本地可执行钩子。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 令牌：将你的投资组合 ID 和 API 密钥用冒号连接（<portfolioId>:<apiKey>），两者都显示在 Awaken 的 Settings → API Keys 中。API 密钥需要 Dolphin 或 Whale 计划。Gemini CLI 使用 API 密钥而非 OAuth 连接。

MCP Registry

server.json 是 Awaken 在官方 MCP Registry 中的条目，tax.awaken/awaken。使用 awaken.tax 域名密钥登录后，通过 mcp-publisher publish 发布更改。

许可证

插件代码和说明采用 MIT 许可证；请参阅 LICENSE。Awaken 徽标是 Awaken 的品牌资产，不受代码许可证涵盖。其源文件为 https://awaken.tax/docs/awaken-word.svg。