内容
# sapiens-mcp
**在官方 [MCP 注册表](https://registry.modelcontextprotocol.io) 上注册为 `com.sapiensinteticos/sapiens`。**
一个MCP服务器，用于从Claude Code或任何MCP客户端在您自己的账户中操作您的 [Sapiens Sintéticos](https://sapiensinteticos.com) 账户。您可以用简单的语言提问（“生成一张图片”，“写一篇关于那的文章”），它会完成工作，消耗您的Sinapses（房屋积分）并保存到您的个人资料中。
Sapiens Sintéticos是一个AI原型实验室。该服务器是外壳：图像、视频、文章、语音、音乐、个人知识库（其他人读取的创作记忆）以及社区，所有这些都来自一次对话。
## 账户设计
您使用Sapiens账户（Google或电子邮件）连接，无需API密钥或卡。账户和登录信息存活在网站上，永远不会在这里。还没有账户？请在 [sapiensinteticos.com](https://sapiensinteticos.com) 上创建一个。每次操作都会显示其成本，生成失败会退款。远程端点是失败关闭的：没有有效的会话，什么都不会运行。
## 连接（两种方式）
**远程（任何MCP客户端，可流式传输HTTP）。** 将您的客户端指向：
```
https://sapiensinteticos.com/api/mcp/mcp
```
带有头部 `Authorization: Bearer <sessionToken>`。在 [sapiensinteticos.com/conectar-claude](https://www.sapiensinteticos.com/conectar-claude) 生成令牌。身份始终是持有者，因此在远程传输上没有本地登录。
**本地（Claude Code，npm / stdio）。**
```bash
claude mcp add sapiens -- npx -y sapiens-mcp
```
Node 18+。后端URL已内置，无需配置。然后登录：打开 [/conectar-claude](https://www.sapiensinteticos.com/conectar-claude) 并登录，生成代码（`XXXX-XXXX`，有效期5分钟），并运行 `sapiens_meta`，带有 `action: "login"` 和 `code: "XXXX-XXXX"`。30天令牌保存在 `~/.sapiens-mcp/session.json` 中。
在Claude Code（测试路径）、Gemini CLI、Cursor、Antigravity和任何MCP客户端上都有效。只有添加方式不同。
## 您可以使用（以及Sinapses的成本）
| 什么 | 成本 |
|---|---|
| 生成图像（到您的画廊） | ~400-500 |
| 用Sapiens语气写文章（到您的个人资料） | 400 |
| 语音/旁白（Helen TTS） | 500 |
| 歌曲歌词/渲染（Musicator） | 300 / 3000 |
| 人物艺术 | 450 |
| 知识库，列出/编辑您的文章，查看余额 | 免费 |
Claude方面总是在花费之前警告成本。在编辑博客和Sapiens栏目上发布内容由平台所有者保留，永远不会是您的账户。
## 故障排除
- **"sessionToken过期" / "Sapiens账户未连接"。** 30天令牌过期或从未保存。打开 [/conectar-claude](https://www.sapiensinteticos.com/conectar-claude) 并登录，生成新的代码，然后运行 `sapiens_meta action=login code=XXXX-XXXX`。
- **更新后工具或新功能消失了。** 客户端通过 `npx -y sapiens-mcp`（未固定）运行，可能卡在旧缓存中。使用 `sapiens_meta action=version`（二进制版本，npm上的最新版本和 `upToDate`）检查正在运行的内容。如果 `upToDate:false`，请清除npx缓存并重启客户端。
- **"无效参数"。** 消息已经指明缺少或错误的字段，请用它要求的内容重试调用。不要重复相同的调用（连续3次失败会使客户端将服务器标记为不可达约1分钟，一个防循环中断器）。
- **生成前余额不足。** `sapiens_meta action=credits`（或 `action=subscription` 获取每个存储桶的详细信息）显示您在花费图像、音乐或视频之前剩余的金额。
## 隐私
服务器仅与公共Sapiens后端（Convex）通信。您的身份始终来自您的登录令牌，永远不会来自松散的参数。每个账户只访问属于自己的内容。
## 房子
来自同一无边界房屋的姐妹属性：
- [sapiensinteticos.com](https://sapiensinteticos.com)：工作室和此服务器的首页。
- [aitag.app](https://aitag.app)：精选的AI工具目录（巴西和欧盟）。Sapiens知识库从此目录中提取。
- [helenai.wtf](https://helenai.wtf)：Helen，房屋的自主人性化AI品牌（音乐，聊天，漫画）。Sapiens的风格锚点。
---
在无边界精神下制作。MIT许可证。 ❤️ [/conectar-claude](https://www.sapiensinteticos.com/conectar-claude)。
