跳至正文
mini.casa
创建你的 casa
带上你的智能体
现已可用

助手可以打造你的 casa，钥匙始终握在你手中。

将 Claude 或任何支持 MCP 的应用连接到你的 Mini Casa 工作区。请它创建 casa、撰写动态、连接域名并检查 DNS。它使用与你相同的工具，仅拥有你授予的权限。

获取令牌 创建 casa

共 107 个工具。新令牌默认为只读，其余权限由你逐项添加。

示例 这里展示的是真实工具名称。发布是独立步骤，你可以另行提出请求。
它能做什么

从第一份草稿，到域名上线，全程打造 casa

这些是智能体可调用的 107 个工具中的一部分。它只能看到令牌权限允许使用的工具。

  • 创建并发布 casa

    挑选 casita、撰写文案和链接、展示预览并发布；如果你改变主意，还能回滚。

    • sw_list_templates
    • sw_get_template
    • sw_create_world
    • sw_update_world
    • sw_get_world
    • sw_preview_revision
    • sw_publish_world
    • sw_rollback_world
  • 撰写动态

    为 casa 添加笔记、链接、图片和项目，后续继续编辑，并设置动态区域的外观。

    • sw_create_post
    • sw_update_post
    • sw_list_posts
    • sw_update_posts_settings
    • sw_delete_post
  • 连接域名

    准备域名，给出需要添加的准确 DNS 记录，并持续检查，直到证书就绪。

    • sw_prepare_domain
    • sw_prepare_dns_plan
    • sw_get_dns_plan
    • sw_verify_domain
    • sw_get_domain
    • sw_list_domains
  • 掌握你的域名

    将你拥有的每个域名放上域名架，告诉你哪些即将续费、费用是多少。

    • sw_import_shelf_domains
    • sw_list_shelf_domains
    • sw_list_expiring_domains
    • sw_get_shelf_summary
    • sw_get_renewal_spend
  • 带上你的链接

    读取你已有的链接页，展示找到的内容，并仅添加你选中的链接。

    • sw_extract_link_page
    • sw_preview_profile_import
    • sw_apply_profile_import
  • 读者与留言

    设置订阅表单，查看订阅者和访客留言，起草回复，并查询统计数据。

    • sw_update_audience_settings
    • sw_list_subscriptions
    • sw_list_inquiries
    • sw_reply_inquiry
    • sw_query_analytics
  • 同时处理多个域名

    将域名列表变成一座座 casa，先模拟运行。你批准具体方案后才会执行。

    • sw_create_portfolio
    • sw_prepare_bulk_plan
    • sw_request_approval
    • sw_execute_bulk_plan
    • sw_get_bulk_run
    • sw_pause_bulk_run
    • sw_rollback_bulk_run
建立连接

两步操作，几分钟搞定

  1. 创建令牌

    登录后打开控制台中的“开发者”。选择“新建连接”，选择 MCP，勾选所需权限并复制令牌。令牌只显示一次，最长有效期为 90 天。

    打开开发者页面

  2. 添加到你的助手

    粘贴以下配置之一，将 sw_mcp_... 替换为你的令牌，并将令牌保存在应用设置中，不要放进聊天。

Claude Code

在终端中运行。添加 --scope user 可在所有项目中使用。

claude mcp add --transport http mini-casa https://mini.casa/mcp \
  --header "Authorization: Bearer sw_mcp_..."

Claude Desktop

将此内容添加到 claude_desktop_config.json，然后重启 Desktop。它使用 mcp-remote 桥接，因此需要 Node.js。

{
  "mcpServers": {
    "mini-casa": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]",
        "https://mini.casa/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sw_mcp_..."
      }
    }
  }
}

其他 MCP 客户端

支持带标头的 HTTP 服务器的客户端，只需填写地址和 Authorization 标头。

{
  "mcpServers": {
    "mini-casa": {
      "url": "https://mini.casa/mcp",
      "headers": {
        "Authorization": "Bearer sw_mcp_..."
      }
    }
  }
}

claude.ai 的自定义连接器和 Claude Desktop 的连接器界面使用 OAuth 登录，Mini Casa 目前尚不支持。开放前，请使用 Claude Code 或上述桥接方式。

地址
https://mini.casa/mcp
传输方式
Streamable HTTP，支持 2026-07-28 协议及当前客户端使用的 2025-11-25 握手
身份验证
Authorization: Bearer 加上你的令牌
你始终掌握控制权

令牌能访问什么，不能访问什么

  • 一个令牌只属于一个工作区。若询问其他工作区，它会如同那个工作区不存在一样回应。
  • 它不会超出你的角色权限，每次调用都会重新检查角色。
  • 权限由你选择。订阅者地址、账单等敏感权限不会默认勾选，启用前还需要重新登录。
  • 除非你另行选择，令牌默认 30 天后过期，最长为 90 天。
  • 在“开发者”页面撤销令牌后，下一次请求即会失效，已排队的任务也包括在内。
  • 访客、订阅者或导入页面中的文字会被标记为不可信数据后交给智能体，绝不会作为指令。

智能体无法执行的操作

  • 批准自己的方案。它可以申请，但只有所有者可以在审核页面批准。
  • 花钱。结账会返回一个链接，由真人完成付款。
  • 向人发送邮件。给访客的回复会保存为草稿，由你发送。
  • 删除或恢复 casa 或账号。这需要你本人在刚完成登录验证后操作。
  • 向服务商写入 DNS 记录。此功能暂时关闭：智能体准备并检查记录，由你在 DNS 托管处添加。
  • 访问其他工作区或他人的 casa。
了解这些会有帮助

常见问题

阅读开发者文档

智能体 API 如何运作

支持哪些助手？

支持通过 HTTP 使用 Model Context Protocol 且能发送 Authorization 标头的应用。Claude Code 可直接使用，Claude Desktop 需通过 mcp-remote 桥接；你的自有脚本还可以使用 REST API。

连接智能体需要额外付费吗？

不需要。每个工作区（包括免费套餐）都能使用令牌，由所有者或管理员创建。智能体适用与你相同的套餐限额，因此套餐未包含的功能，它同样无法使用。

应该授予哪些权限？

从默认只读权限开始，按任务需要添加：建页面需要 casa 编辑权限，连接域名需要域名权限。没有权限的工具完全不会向它显示。

令牌泄露了怎么办？

在“开发者”页面撤销，下一次请求就会失效。我们只存储令牌的哈希值，任何人都无法读回原令牌；所有令牌最迟也会在 90 天内过期。

助手可以帮我报告问题吗？

可以。请它发送反馈，它会使用任意令牌都能调用的 sw_submit_feedback。报告会附带你的账号信息送达支持收件箱，若你允许，我们便可跟进。加入个人信息前，它会先征求你的同意。

我的代码可以使用 API 吗？

可以。同样的操作也通过 /api/v1 的 REST API 提供，并附有 OpenAPI 文档。创建令牌时选择“REST API”而非 MCP 即可。

创建 casa

准备拥有自己的地方了吗？

选择场景，添加文字与链接，然后通过免费的 Mini Casa 地址发布。

创建你的 casa 查看所有功能