# @zackbart/connecta 中文文档
规范地址：https://npmcn.com/package/%40zackbart/connecta/
版本：0\.40\.0
npm 元数据更新时间：2026-11-02T23:08:32.827Z
中文译文更新时间：2026-11-02T23:54:08.314Z
软件包许可：MIT
本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40zackbart/connecta
原文对照：https://npmcn.com/package/%40zackbart/connecta/?lang=original
项目主页：https://github.com/zackbart/connecta#readme
源码仓库：https://github.com/zackbart/connecta
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：12.5 MB，522 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.13\.0
- 运行依赖：6 个
- peer 依赖：undici 6\.29\.1，@clerk/backend ^3\.12\.0，quickjs-emscripten ^0\.32\.0，@cloudflare/codemode ^0\.4\.4 \|\| ^0\.5\.0
- 首次发布：2026-07-24T03:53:36.952Z
- 最新版本发布：2026-11-02T23:08:32.504Z
- 已发布版本数：86（近 12 个月 86 个）
## 中文简介
一个MCP来统治它们——一个单独的MCP端点在六个元工具的代码优先表面后面聚集了许多下游连接器。
## 安装
```sh
npm install @zackbart/connecta
```
也可以使用：`pnpm add @zackbart/connecta`、`yarn add @zackbart/connecta`、`bun add @zackbart/connecta`
## README
# connecta
**您的代理和您选择的服务之间的一个连接。**
Connecta将代理所需的服务置于一个连接之后。它使用 **模型上下文协议（MCP）**这是一个允许人工智能应用程序使用工具的标准。 运行Connecta并选择每个代理可以访问的内容。
```mermaid
flowchart LR
Agents["Agent apps and people"] --> Pools
subgraph Connecta["Your Connecta server"]
Pools["Pools
which tools each caller can use"] --> Checks["Access checks
reads · changes · secrets"]
end
Checks --> Stripe
Checks --> Google["Google Workspace"]
Checks --> Other["Other services"]
```
工具是一种操作，例如查找票据或更新记录。代理 可以直接调用一个动作还是在一个短程序中组合几个动作 Connecta。程序可以返回一个小的答案，而不是每条记录。 Connecta提供服务凭据，因此代理不需要它们。
## 你能连接什么
维护连接：Breeze ChMS，教堂社区建设者，Cloudflare, GitHub, Gmail，谷歌文档，谷歌驱动器，谷歌表格，谷歌表格，谷歌幻灯片，格兰诺拉，溢出，规划中心，QuickBooks Online, Stripe，什一奉献。ly和Vercel。
维护的API提供者将审查的供应商契约与由 Connecta。看到 [API源和工具清单](https://npmcn.com/package/%40zackbart/connecta/documentation/providers.md#api-sources-and-tool-inventory) 查看每个提供商的命名工作流和审查的API工具。
也可以通过以下方式连接其他托管的MCP工具服务器 `remoteMcp()`， 它发现服务器的实时工具目录，或者描述API连接 应该叫。
## 它保护什么
| 边界 | 康涅狄格做了什么 |
| --- | --- |
| 访问 | 一个池子限制了它的成员可以使用的工具；它只列出人或代理人。 |
| 写 | 对于标记为写的工具，一旦发送了更改，Connecta将不会自动再次发送它。 |
| 秘密 | 已知的秘密从代理输出中编辑。启用凭据库来加密存储的凭据和OAuth令牌。 |
| 只读访问 | 只读端点隐藏写操作并拒绝调用它们的尝试。 |
只读保护和单次写入依赖于真实的工具标签。 使用Connecta的人工智能应用程序决定何时请求批准；可写池 可以在无人看管的情况下写作。 [安全与信任](https://npmcn.com/package/%40zackbart/connecta/guides/safety-and-trust.md) 解释这些界限和它们的限制。
## 试着分三步来做
您需要在某个地方运行Connecta并获得连接该服务的权限 您选择的帐户。创建项目是设置的开始；账户 连接和访问规则仍然需要配置。
1. **创建部署。** 从Node模板开始：
```sh
npx @zackbart/connecta init my-connecta
cd my-connecta
npm install
```
2. **选择服务和访问。** 您的操作员-运行的人或团队 connect -可以使用编码助手作为设置代理。给那个助手 这个 [运营商的文档](https://npmcn.com/package/%40zackbart/connecta/documentation/README.md)。它配置 服务，启用凭证库，连接帐户，并启动 带有您选择的访问规则的服务器。
3. **连接你的AI应用。** 这个应用程序是MCP客户端：它使用Connecta的 工具代表你的代理。为它提供池地址和身份验证 操作符提供的方法。一个人在一个游泳池可以使用 平原 `/mcp` 地址;他们的登录选择池。 [连接代理](https://npmcn.com/package/%40zackbart/connecta/guides/connecting-agents.md) 解释要求什么；这个 [部署指南](https://npmcn.com/package/%40zackbart/connecta/documentation/deploying.md) 具有可运行的步骤。
```mermaid
flowchart LR
Create["1 · Create"] --> Configure["2 · Choose services + access"] --> Connect["3 · Connect your AI app"]
```
包裹是 `@zackbart/connecta` （`npm install @zackbart/connecta`）. 运行它 在Node、Docker或Cloudflare Workers上。这个 [部署指南](https://npmcn.com/package/%40zackbart/connecta/documentation/deploying.md#choose-a-deployment) 覆盖每一个。
## 多读一点
| 指南 | 你会明白什么 |
| --- | --- |
| [它是如何工作的](https://npmcn.com/package/%40zackbart/connecta/guides/how-it-works.md) | 连接器、池、人员以及调用到达服务的方式。 |
| [连接代理](https://npmcn.com/package/%40zackbart/connecta/guides/connecting-agents.md) | 代理令牌，Vercel身份，以及可选的Eve助手。 |
| [安全与信任](https://npmcn.com/package/%40zackbart/connecta/guides/safety-and-trust.md) | 不确定的变化，秘密，只读访问，和你的职责。 |
| [运营商的文档](https://npmcn.com/package/%40zackbart/connecta/documentation/README.md) | 设置、功能可用性、升级和确切的合同。 |
升级吗?遵循 [升级指南](https://npmcn.com/package/%40zackbart/connecta/documentation/deploying.md#upgrade-an-existing-deployment). 0.29之前的存储和OAuth布局必须首先迁移到0.37.1；看到 [桥梁升级要求](https://npmcn.com/package/%40zackbart/connecta/documentation/migration-retired-layouts.md). 预计在1.0之前会有突破性的变化。看到 [更新日志](https://npmcn.com/package/%40zackbart/connecta/CHANGELOG.md) 和 [安全策略](https://npmcn.com/package/%40zackbart/connecta/SECURITY.md).
## 常见问题
### @zackbart/connecta 是什么？
一个MCP来统治它们——一个单独的MCP端点在六个元工具的代码优先表面后面聚集了许多下游连接器。
### 如何安装 @zackbart/connecta？
在项目目录运行 npm install @zackbart/connecta，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 connecta，可以用 npx connecta 直接运行。
### @zackbart/connecta 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @zackbart/connecta 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。
### @zackbart/connecta 需要什么版本的 Node\.js？
package\.json 的 engines 字段要求 Node\.js \>=22\.13\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
### @zackbart/connecta 可以商用吗？
@zackbart/connecta 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @zackbart/connecta 还在维护吗？
最新版本 0\.40\.0 发布于 2026/11/03（今天）；至今共发布 86 个版本，其中过去 12 个月发布了 86 个；首次发布于 2026/07/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。