跳到主要内容

连接 PassportCraft

用您的 AI 工具起草数字产品护照

把 PassportCraft 连接到您已经在用的助手。它读取您的产品目录、起草产品护照、附上您的文件,并告诉您还缺什么。发布这一步,始终由您点击。

支持ClaudeChatGPTCursorWindsurfGitHub Copilot+ 任何 MCP 客户端

几分钟即可启用

选择您的客户端:一个网址,一次登录。无需 SDK,无需写代码。

服务器地址
https://passportcraft.com/api/mcp

使用 Team 或 Enterprise 时,所有者须先在 Organization settings → Connectors → Add → Custom → Web 中添加 PassportCraft,成员随后即可连接。

Claude

  1. 1
    打开连接器

    使用个人账户时,在 Claude 中打开 Customize → Connectors,选择 +,再选择 Add custom connector。使用团队账户时,选择所有者已添加的连接器,然后转到第 3 步。打开 Claude 连接器 ↗

  2. 2
    添加 PassportCraft

    将名称设为 PassportCraft,并粘贴此处显示的服务器地址。将 OAuth Client ID 和 Client Secret 留空,然后添加连接器。如果系统要求选择登录方式,请选择 Dynamic Client Registration(DCR)。

  3. 3
    连接您的工作区

    选择 Connect 并登录 PassportCraft。选择工作区,查看访问权限后再授权。在聊天中通过 + → Connectors 启用 PassportCraft。

创建免费账户,连接您的 AI 工具。所有套餐均包含连接器功能。任何支持 HTTP 的 MCP 客户端都可以使用同一 URL。

MCP 服务器地址
https://passportcraft.com/api/mcp

连接后,问一句“我可以用 PassportCraft 做什么?”,您的助手就会说明连接器的全部能力。

传输方式
Streamable HTTP
登录
OAuth 2.0——无需粘贴 API 密钥
可及范围
每个连接对应一个工作区
套餐
所有套餐,含免费套餐
撤销
随时可在设置中撤销

工作方式

一次连接,三点要义。

01

连接一次

您登录,并选择助手可以访问哪个工作区。您授权的那个界面显示的是您要发送到的地址,而不是应用自己声称的名称——名称可以伪造,地址不能。

02

在对话中完成

起草、修改、从对话中发送文件,还有一项检查,会明确指出缺口所在。

03

由您发布

助手只能提出请求。您收到一个链接,读完它写了什么,然后点击“发布”。

可以这样问

连接之后,一句话就能推进产品护照的工作。

“为这份产品清单上的十二个款式创建产品护照。”

“我的草稿里,哪些还缺再生材料含量?”

“把这份纺纱厂证书附到货号 4471 的草稿上。”

“检查我的亚麻草稿,列出阻碍发布的问题。”

“把春季草稿的原产国改为葡萄牙。”

“把所有通过检查的都提请我发布。”

助手能做什么

十七项工具,全部通过产品其余部分所用的同一套接口:同样的工作区边界,同样的用量限制,同样的变更记录。

工具用途可及范围
list_passports · get_passport读取您的产品目录,以及任意一份完整的产品护照——草稿和已发布的都可以。读取
get_category_schema在写入任何内容之前,先查询某个产品类别需要哪些字段。读取
validate_passport检查草稿,返回阻碍发布的具体缺口。读取
create_passport创建产品护照,始终以草稿形式创建。仅限草稿
update_passport修改草稿。它写入的每个字段都会被标记为它所写。仅限草稿
upload_document把对话中的小图片放入您的文件库,并附到草稿上。若是数据表或声明,助手会给您一个链接,打开草稿并准备好接收文件——由您选择文件,文件会完整送达。所有内容都存放在公众无法访问的位置。仅限草稿
attach_document · list_documents附上文件库中已有的文件,并列出某份产品护照包含哪些文件。仅限草稿
list_library显示文件库中已有的文件,让它重复使用,而不是再发送一次。读取
list_variants读取纺织品或通用产品护照中保存的条码、尺码和颜色。读取
add_variants将您提供的条码、尺码和颜色添加到纺织品或通用产品护照的草稿中。仅限草稿
list_units · create_unit · list_unit_readings为某个电池型号登记序列号。写入
request_publish请求您发布。返回一个由您打开的链接。它从不发布。由您决定
get_publish_approval查看该请求后来的结果。超过期限的请求会自行过期,这次查看则把它记录下来。读取

以下这些,助手都没有对应的工具:发布、删除任何内容、把产品从其公开页面撤下、移入回收站或从中恢复,以及向法国政府提交申报。其中撤下、回收站和申报还会在连接层面被直接拒绝,因此连接器也无法通过其他途径触及。

由您发布

已发布的产品护照,是您向监管机构作出的声明。这四条规则,把这一刻——以及公众能看到的一切——留在您手中。

它永远无法发布

当它请求发布时,会提交一个请求并收到一个链接。由您打开链接并点击“发布”。这一步无法绕过。

它碰不到已上线的内容

它写入草稿。若您要它修改公众已能看到的产品护照,它只会给您一个通往编辑器的链接。有一处例外,我们写明而不藏起来:它可以为您已经发布的电池型号登记序列号。

它写入的每个值都会被标记

助手写入的字段会在编辑器中标记出来,并连同取值一起列在您发布前确认的那个界面上。您若自行修改其中一个,标记随即消失——那就是您的值了。

范围很窄,且随时可由您终止

六项固定权限,其中不包含向监管机构申报。每个连接对应一个工作区。在设置中撤销,立即失效。

常见问题

助手可以发布产品护照吗?

不可以。当它请求发布时,会收到一个链接。您打开该链接,逐一查看助手写入的每个字段及其取值,然后由您自己点击“发布”。这一步无法绕过。

它能修改已经上线的产品护照吗?

几乎不能,但这处例外值得知道。公众能看到的产品护照,是您已作出的声明,因此助手写入草稿;若您要它修改已发布的护照,它会给您一个通往编辑器的链接。例外是为您已发布的电池型号登记序列号——这是常规的编号发放,我们接口的其余部分同样如此处理。每个单元所记录的状态被限制在一份固定清单内。但序列号本身是自由文本,当有人扫描该单元时会显示在公开页面上,因此请把它当作您公开发布的内容来对待。

我如何拒绝一个发布请求?

没有“拒绝”按钮。您可以不理会该请求,七天后它会自行过期。助手再次修改草稿时,该请求也会立即被撤回——它改动的字段、它添加的文件,都算修改。您自己的修改不会撤回请求:请求会一直等着您,直到您发布或它过期。

费用如何?

连接器包含在所有套餐中,免费套餐也一样。起草不收费。需要套餐的是发布:免费套餐可发布三份产品护照。

它支持哪些对话工具?

网页版和桌面版 Claude、Claude Code、ChatGPT、Cursor、Windsurf、搭配 GitHub Copilot 的 VS Code 和 Gemini CLI——以及其他任何通过 HTTP 支持 MCP 并采用 OAuth 登录的工具。

我怎么知道助手写了什么?

它写入的字段会在编辑器中标记出来,并连同取值列在您发布前经过的确认界面上。该列表从不省略。您若自行修改某个值,标记随即消失。

助手发送的文件会怎样处理?

文件会进入您工作区的文件库并附到草稿上,存放在公众无法访问的位置,直到您手动将其公开。有两点需要知道:草稿删除后,文件仍留在文件库中;而文件库不会区分文件来自助手还是来自真人。

PassportCraft 对助手本身究竟承诺了什么?

对它的行为方式,我们不作任何承诺——模型和对话都属于您,不属于我们。我们的承诺写在连接本身之中:它写草稿,绝不发布,而它写入的每个值都会被标记,并在您发布之前逐项告知您。唯一会到达公众的写入,是为您已发布的电池型号登记序列号,而每一条所记录的状态被限制在一份固定清单内。

如何断开连接?

在设置中撤销该连接。它会立即失效,而它起草的产品护照会原样保留。

立即连接您的 AI 工具

所有套餐均可使用,含免费套餐。几分钟内在对话中起草您的第一份产品护照——再由您自己发布。