MCP 连接器
在 AI 助手里直接用 Portaxo
接好一次,之后一句话就够了:让它找某个产品的美国进口商(也能找生产它的海外工厂),或者按公司名直接查;解锁这些美国买家的采购联系人(邮箱,有直拨电话的一并给出),写好一封邮件或一组开发信(发给这些买家,或者你联系人里已有的人),再从你自己的邮箱发出去。WorkBuddy、千问办公这些国产助手也能接。
它能做什么
让 AI 助手替你在 Portaxo 里干活
Portaxo 的 MCP 服务器,让 AI 助手可以替你做平时在“找买家”“线索”“邮件外联”里做的事:按产品查美国海关记录,找出正在进口的美国公司,或者正在往美国出货的海外工厂和贸易商,也能按你说的公司名直接查;对找到的美国买家,先核实公司官网,再解锁公司里的采购联系人(邮箱,有直拨电话的也一并给出);把一封邮件或开发信序列写成草稿,发给这些买家或你联系人里已有的人;等你点头,再从你自己的邮箱发出去。Claude(包括 Claude Code)、Codex 和 ChatGPT 在浏览器里登录,其他助手用访问令牌接入。在中国大陆、香港、澳门用不了 Claude、Codex 和 ChatGPT,请直接看国产助手怎么接。
https://api.portaxo.com/mcp原样粘贴 https://api.portaxo.com/mcp,末尾不要加斜杠。portaxo.com/zh/mcp/ 是这一页说明,不是服务器地址,填它是连不上的。
- 服务器地址
https://api.portaxo.com/mcp- 传输方式
- Streamable HTTP。每个请求都是 POST,返回 JSON。
- 登录方式
- 浏览器里的 OAuth 2.1 登录,支持动态客户端注册(DCR,不支持 CIMD);或者个人访问令牌,放在请求头
Authorization: Bearer ptx_…里发送。 - 以谁的身份
- 批准登录、或者创建令牌的那个 Portaxo 用户,花的是他所在组织的积分。
- 工具
- 十三个:
get_account、campaign_status、find_buyers、find_suppliers、find_company、unlock_contacts、find_contacts、create_campaign、add_recipients、remove_recipients、update_campaign、pause_campaign、launch_campaign。费用和权限 - 响应时间
- 每次调用最多约 45 秒。没做完的会返回
in_progress,助手会自己再调一次。 - 套餐
- 任何套餐都能接入,
get_account和find_company都能用。按产品找买家、找供应商需要“品类检索”,find_contacts和活动工具需要“开发信”功能,免费版两样都没有,会返回PLAN_UPGRADE_REQUIRED。 - 帮助
- 就是这一页;给 AI 读的英文摘要在 llms.txt;有问题写信到 hello@portaxo.com。
Claude
添加到 Claude
两种接法,都在浏览器里登录:网页版、桌面版和手机上的 Claude,点一个预填好的链接就行;命令行里的 Claude Code,运行一条命令就行。适用于能使用 Claude 的地区,中国大陆、香港、澳门不在其中。
网页版、桌面版和手机 App
点一下链接,Claude 的添加连接器窗口会自动填好 Portaxo 的名称和地址。在 claude.ai 上加好一次,同一个 Claude 账户的桌面版和手机 App 里也都能用。
保持默认,点 Add,再点 Connect
“Sign in now”和“Register automatically (DCR)”保持默认不动。先点 Add,再点 Connect。
在 Portaxo 页面上批准
浏览器会打开 Portaxo。需要的话先登录,确认页面上显示的是你想让助手使用的那个账户,然后点 批准。
在对话里打开它
在对话里点 + → Connectors,确认 Portaxo 是打开的。然后问一句“看看我的 Portaxo 账户”。
- Claude 桌面版:在网页上加好的连接器,已经打开的桌面版要刷新(Ctrl+R)或者重启之后才会出现。
- 权限:Claude 每次调用工具前都会先问你。“Always allow”只对那一个工具生效;想一次设置全部工具,去 Customize → Connectors → Portaxo。下面的工具表给了每个工具的建议设置。
- Team / Enterprise:只有 Owner 能添加自定义连接器,用管理员版本的链接。之后每个成员在 Customize → Connectors 里找到 Portaxo,点 Connect,登录自己的 Portaxo 账户。
- Claude 免费版:只能添加一个自定义连接器。
Claude Code(命令行)
Anthropic 出的编程助手,在终端里用。一条命令加上 Portaxo,再在 Claude Code 里登录。
添加服务器
在终端里运行:
claude mcp add --transport http portaxo https://api.portaxo.com/mcp这样加的 Portaxo,只在你当前这个文件夹里运行 Claude Code 时才有。想在所有项目里都能用,在 claude mcp add 后面加上 --scope user。
在 Claude Code 里登录
启动 Claude Code,运行 /mcp,选 portaxo,再选 Authenticate。浏览器会打开 Portaxo:需要的话先登录,确认显示的账户没错,然后点 批准。
确认已经连上
再运行一次 /mcp,portaxo 会显示为已连接(connected)。然后问一句“看看我的 Portaxo 账户”。
- 已经在 claude.ai 上加过?Claude Code 登录的是同一个 Claude 账户时,你在 claude.ai 上加的连接器也会出现在它的
/mcp列表里,不运行上面的命令,Portaxo 可能也已经在了。
这台机器打不开浏览器
在服务器上,或者任何打不开浏览器登录的地方,改用访问令牌接入。把 TOKEN 换成你的令牌,Bearer 和它后面的空格要保留。
claude mcp add --transport http portaxo https://api.portaxo.com/mcp --header "Authorization: Bearer TOKEN"Codex
添加到 Codex
Codex 是 OpenAI 的编程助手,ChatGPT 的套餐里就带着它。它的命令行、桌面版和 IDE 插件共用一个配置文件 ~/.codex/config.toml,在其中一个里加好 Portaxo,另外两个也就有了。三者都在浏览器里登录。和 ChatGPT 一样,Codex 不在中国大陆、香港、澳门提供服务。
Codex 命令行(CLI)
添加服务器
在终端里运行。Codex 会自己找到 Portaxo 的登录入口,并打开浏览器。
codex mcp add portaxo --url https://api.portaxo.com/mcp在 Portaxo 页面上批准
需要的话先登录,确认显示的是你想让 Codex 使用的那个账户,然后点 批准。登录状态由 Codex 自己保存、自己续期。
确认已经连上
启动 Codex,运行 /mcp,能看到 portaxo 和它的工具。然后问一句“看看我的 Portaxo 账户”。如果浏览器没有打开,或者你之前断开过 Codex,用这条重新登录:
codex mcp login portaxoCodex 桌面版和 IDE 插件
已经在命令行里加过了?桌面版和插件读的是同一个配置文件,Portaxo 已经在列表里,提示时点 Authenticate 就行。没加过的话,按下面的步骤加。不同版本的菜单名称可能略有不同。
Codex 桌面版
- 打开 Settings → MCP servers → Add server。
- 名称填
portaxo,选择 Streamable HTTP,填入服务器地址https://api.portaxo.com/mcp。 - 点 Save,再点 Restart。
- 点 Authenticate,到 Portaxo 页面上批准。
Codex IDE 插件(VS Code、Cursor)
- 在 Codex 面板里点齿轮图标,再打开 MCP servers → Add server。
- 填同样的内容:名称
portaxo,选 Streamable HTTP,填入服务器地址。 - 保存,然后点 Restart extension。
- 点 Authenticate,到 Portaxo 页面上批准。
这台机器打不开浏览器
适合服务器,或者打不开浏览器登录的机器:给 Codex 命令行一个访问令牌。Codex 每次启动都会从环境变量 PORTAXO_TOKEN 里读令牌,所以要把它设在长期有效的地方,再新开一个终端。只在当前终端里 export 一次,换个终端就没了,Codex 会被拒绝。
export PORTAXO_TOKEN=TOKENsetx PORTAXO_TOKEN TOKENcodex mcp add portaxo --url https://api.portaxo.com/mcp --bearer-token-env-var PORTAXO_TOKEN其他应用
添加到其他应用
ChatGPT 和 Claude、Codex 一样,在浏览器里登录。WorkBuddy、千问办公、豆包、Cursor、VS Code,以及其他支持 MCP 的助手,都用个人访问令牌接入;在中国大陆、香港、澳门,走的也是这条路。
ChatGPT
新建自定义 MCP 服务器
打开 chatgpt.com/plugins,点 +,选 Create custom MCP server。
填好 Portaxo
名称:Portaxo。地址:服务器地址 https://api.portaxo.com/mcp。认证方式:OAuth。
在 Portaxo 页面上批准
创建之后登录 Portaxo,点 批准。
- 哪些 ChatGPT 套餐能使用会改动数据的工具(比如解锁联系人、启动活动),OpenAI 自己的文档说法不一。如果你的套餐用不了,请改用 Claude 或 Codex。
WorkBuddy、千问办公、豆包、Cursor、VS Code:用访问令牌接入
Claude、Codex 和 ChatGPT 不在中国大陆、香港、澳门提供服务。在这些地方,用国产桌面助手加一个 Portaxo 访问令牌接入就行,Cursor 和 VS Code 也走这条路。令牌就等于你本人:能花积分,也能发邮件,请像保管密码一样保管它。
在 Portaxo 里创建令牌
打开 账户设置 → API 与 MCP → 访问令牌,或者 App 里“文档”中的 AI 助手指南。按要用的助手给令牌起名(比如“WorkBuddy”),创建后马上复制:它以 ptx_ 开头,只显示这一次。
把配置粘进助手
在下面找到你用的助手,复制配置,把 TOKEN 换成你的令牌。Bearer 和它后面的空格要保留。
先问一句不花钱的
“看看我的 Portaxo 账户”会调用 get_account,不花积分,能确认连接已经通了。
- 每人最多 10 个令牌。令牌不会自动过期;哪个助手不用了,就在同一页把它的令牌撤销。
- 修改或重置密码,或者点 全部退出,会一次性撤销所有令牌、断开所有已连接的应用。
- 这些配置是存在你电脑上的明文文件,不要提交到代码仓库,也不要发给别人。
- 不同版本的菜单名称可能略有不同,以你手上的版本为准。
腾讯 WorkBuddy
桌面版。在“连接器”里点 自定义连接器 → 配置MCP,粘贴下面这段并保存:
{
"mcpServers": {
"portaxo": {
"type": "http",
"url": "https://api.portaxo.com/mcp",
"headers": {
"Authorization": "Bearer TOKEN"
},
"disabled": false
}
}
}千问办公
桌面版。连接器 → 添加,选择粘贴 JSON 配置:
{
"mcpServers": {
"portaxo": {
"type": "streamable-http",
"url": "https://api.portaxo.com/mcp",
"headers": {
"Authorization": "Bearer TOKEN"
}
}
}
}也可以手动填:服务器类型选 Streamable HTTP,地址填服务器地址;在 Headers 旁边点“粘贴”,贴入下面这一行,再点 解析,然后保存。
Authorization: Bearer TOKEN豆包电脑版
新建自定义连接器,传输方式选 HTTP,地址填服务器地址,再加上放令牌的请求头(Authorization),内容是下面这一行。如果你的版本没有填请求头的地方,先用 WorkBuddy 或千问办公。
Authorization: Bearer TOKENCursor
Cursor Settings → Tools & MCP → Add Custom MCP 会打开 mcp.json,加入:
{
"mcpServers": {
"portaxo": {
"url": "https://api.portaxo.com/mcp",
"headers": {
"Authorization": "Bearer TOKEN"
}
}
}
}VS Code
在项目的 .vscode/mcp.json 里加入:
{
"servers": {
"portaxo": {
"type": "http",
"url": "https://api.portaxo.com/mcp",
"headers": {
"Authorization": "Bearer TOKEN"
}
}
}
}其他支持 Streamable HTTP 的 MCP 客户端也都能接:向服务器地址发 POST,带上 Authorization: Bearer TOKEN、Content-Type: application/json,以及同时列出 application/json 和 text/event-stream 的 Accept 请求头。
工具
工具
每个工具做什么、花多少积分,以及建议你在助手里给它什么权限。常见顺序是:先 get_account,再 find_buyers,然后 unlock_contacts、create_campaign,用 update_campaign 改好草稿,最后 launch_campaign;之后用 campaign_status 和 pause_campaign 跟进。你说的是公司名而不是产品时,用 find_company 代替 find_buyers。要给你联系人里已有的人写信,用 find_contacts 代替检索和解锁。一封邮件就是只有一步的活动,草稿也可以先不加人:用 add_recipients 和 remove_recipients 调整发给谁。find_suppliers 单独用来找货源。助手不能解锁供应商联系人,请在网页版“找供应商”里解锁。
| 工具 | 做什么 | 积分 | 建议权限 |
|---|---|---|---|
get_account | Portaxo 账户 当前连接的是谁、组织还剩多少积分、每一步的价格、你的发信邮箱,以及最近的活动。 | 免费 | 始终允许 |
campaign_status | 活动进度 一个活动发出、失败、回复和待发的数量,它现在的每一封邮件,以及收件人有哪些(每次列出 50 人,也可以按名字查)。 | 免费 | 始终允许 |
find_buyers | 找某个产品的美国买家 按海关记录返回一页正在进口这个产品的美国公司:提单数、最近一次出货,以及它看起来是真实买家还是货代等中间方。 | 每新解锁一家公司 1 积分。按你要的数量先冻结,再按实际新解锁的数量结算;已经解锁过的公司不收费。 | 需要确认 |
find_suppliers | 找某个产品的海外供应商 正在往美国出这个货的工厂和贸易公司:国家、提单数、最近一次出货、美国客户,以及判断它是工厂、贸易商还是物流公司的结论和理由(Portaxo 有结论时才有)。用于找货源:结果不能交给 unlock_contacts。助手不能解锁供应商联系人,请在网页版“找供应商”里解锁。 | 每新解锁一家供应商 1 积分。按你要的数量先冻结;已经解锁过的不收费。 | 需要确认 |
find_company | 按公司名查找 按你说的公司名在海关记录里查:美国买家(默认)或海外供应商,给出的信息和按产品检索一样。查到的买家可以直接交给 unlock_contacts;供应商联系人只能在网页版“找供应商”里解锁。所有套餐都能用;免费版每次最多 5 家、只有第一页,每天可以按公司名查 5 次。 | 每新解锁一家公司 1 积分。按你要的数量(最多 10 家)先冻结;已经解锁过的不收费。 | 需要确认 |
unlock_contacts | 解锁买家联系人 针对 find_buyers 或 find_company 找到的美国买家:先核实每家公司的官网,再解锁这家公司里的联系人:姓名、职位、邮箱,有直拨电话的也一并给出。只有有邮箱的人能加进开发信活动,其余的可以打电话联系。积分上限由你来定。 | 找到新联系人的公司 5 积分;查了但没有新人的 1 积分;已经解锁过的 0 积分。电话随同一次解锁给出,不另收费。 | 需要确认 |
find_contacts | 查找你的联系人 在你的 Portaxo 联系人里,按姓名、公司、标签或外联记录查找已有的人,比如“Acme 公司的所有人”“标签是展会的所有人”,并告诉你之前有没有给每个人发过邮件。列出的是你在网页版能看到的联系人:默认只有你自己的,组织开启共享后是全组织的。和活动工具一样,需要套餐包含“开发信”功能。 | 免费 | 始终允许 |
create_campaign | 起草一封邮件或邮件序列 写一封邮件,或最多 5 封、带跟进的邮件序列,存成草稿。收件人可加可不加:你的联系人、解锁过的买家,或者先空着、以后再加。不会发出任何邮件。 | 免费 | 始终允许 草稿永远不会自己发出。 |
add_recipients | 往草稿里加人 把你的联系人,或者用 unlock_contacts 解锁的买家,加进一个草稿活动。已经在里面的人会自动跳过。 | 免费 | 始终允许 草稿永远不会自己发出。 |
remove_recipients | 从草稿里移除收件人 在活动启动前,把人从草稿里移出。联系人本身不会被删除。 | 免费 | 始终允许 |
update_campaign | 修改草稿活动 修改草稿的名称、邮件内容或发信邮箱。 | 免费 | 始终允许 |
pause_campaign | 暂停活动 让正在发送的活动停下来。再启动一次就会继续。 | 免费 | 始终允许 |
launch_campaign | 启动活动(会真实发出邮件) 从你的邮箱开始发送一个草稿,或者让暂停的活动继续发。 | 免费,但会真实发出邮件,发出后无法撤回。 | 需要确认 |
费用和限制
花多少积分,发得多快
通过 MCP 用 Portaxo,收费和网页版一样,从你组织共用的积分余额里扣。随时问一句账户情况,就能看到还剩多少。
积分
- 检索(按产品或按公司名):每新解锁一家公司或供应商 1 积分。检索开始时按你要的数量先冻结,再按实际新解锁的数量结算;已经解锁过的结果不收费。
- 找供应商不会为供应商详情或联系人扣你的积分。
- 联系人:找到新联系人的公司 5 积分,查了但没有新人的 1 积分,已经解锁过的 0 积分。有直拨电话的随同一次解锁给出,不另收费。助手不会超过你给的积分上限。
- 核实官网不花积分,但每个组织每天有查询次数上限(默认 100 次,和网页版共用)。
- 账户、联系人、活动和进度这几个工具都免费。
限制
- 每次调用最多约 45 秒就会回复。没做完的会返回
in_progress:这不是失败,助手会再调一次把结果取回来。 - 新的一次找供应商,Portaxo 有结论的供应商(工厂、贸易商或物流公司)大约在 90 秒后出来,所以助手会在大约一分钟后再免费读一次。有些供应商暂时还没有结论。
- 按公司名查找每页最多 10 家。免费版每次最多 5 家、只有第一页,每个组织每天可以按公司名查 5 次,和网页版共用。
- 每个活动最多 200 个收件人,而且只能加有邮箱的人;名单更长会自动拆成几个活动,往草稿里加人也不会超过 200 个。
- 每个邮箱大约一分钟发一封,直到达到这个邮箱的每日上限(在“邮件外联”里设置,新邮箱默认 20 封)。200 个收件人、每天 20 封,第一封要发 10 天。
- 你的签名会自动加在每封邮件末尾,助手不需要再写。
点“允许”之前
它就是以你的身份在做事
接进来的助手拥有你 Portaxo 账户的全部权限。下面是它做事的规矩。
花你的积分,用你的邮箱
助手花的是你组织的积分,发信用的是你的邮箱,和你自己在网页版里操作一样。
草稿不会自己发出
创建、修改活动,或者调整发给谁,都只是改草稿。只有 launch_campaign 会发信,所以请让它保持“需要确认”。
发出的邮件撤不回来
邮件一旦发出就收不回了。pause_campaign 能拦住还没发出去的部分。
随时可以断开
账户设置 → API 与 MCP → 已连接的应用 → 断开。助手的下一个请求就会被拒绝。令牌在同一页撤销。
套餐和地区
谁能用,在哪儿能用
套餐
- 每个 Portaxo 账户都能接入 AI 助手,
get_account和find_company在所有套餐上都能用。 - 按产品找买家、找供应商需要“品类检索”,查找联系人和开发信活动需要“开发信”功能,免费版两样都没有。在免费版上,
find_buyers、find_suppliers、find_contacts和七个活动工具(create_campaign、update_campaign、add_recipients、remove_recipients、launch_campaign、pause_campaign、campaign_status)都会返回PLAN_UPGRADE_REQUIRED。 - 其他功能和网页版一样,按你的套餐来。详见价格。
地区
- Claude、Codex 和 ChatGPT 不在中国大陆、香港、澳门提供服务。
- 在这些地方,请用腾讯 WorkBuddy、千问办公这类国产桌面助手,加访问令牌接入。
第一句话问什么
八句可以直接拿来问的话
先做一次不花钱的账户检查;花积分之前先看结果;任何邮件发出去之前,先看草稿。进口商检索之后的解锁联系人、写草稿和启动活动,针对的是它找到的美国买家;介绍新目录的那封邮件,发给你联系人里已有的人;找海外工厂是为了找货源。
- “看看我的 Portaxo 账户” 免费。确认连接通了,顺便看看还有多少积分。
- “帮我找 20 家美国的卷尺进口商” 最多 20 积分,先冻结,按新解锁的公司结算。
- “解锁前 5 家公司的采购联系人,最多花 30 积分” 指进口商检索结果里排在前面的 5 家美国买家。有新联系人的公司每家 5 积分,上限你说了算。
- “给这些联系人写一个 3 封邮件的开发信序列,先给我看草稿” 免费。只存草稿,不会发出。
- “启动这个活动” 会从你的邮箱真实发出邮件。
- “这个活动有人回复吗?” 免费。
- “给联系人里标签是展会的所有人写一封邮件草稿,介绍我们的新产品目录” 免费。给你已有的联系人写一封邮件,只存草稿,不会发出。
- “找出口卷尺到美国的海外工厂” 每家新解锁的供应商 1 积分。这是找货源用的:助手不能解锁供应商联系人,请在网页版“找供应商”里解锁。
隐私和支持
你的数据、服务条款和联系方式
工具返回的公司、联系人和活动数据,和你在网页版里看到的一样,只发给你接入的那个助手。Portaxo 怎么处理这些数据,写在隐私政策里;通过任何助手使用 Portaxo,都适用服务条款。有问题,或者怎么都连不上,写信到 hello@portaxo.com。
常见问题
直接回答
Portaxo 的 MCP 服务器地址是哪个?
https://api.portaxo.com/mcp,原样填写,末尾不要加斜杠。portaxo.com/zh/mcp/ 是这一页说明,不是服务器地址,填它是连不上的。
在中国大陆能用吗?
Claude、Codex 和 ChatGPT 不在中国大陆、香港、澳门提供服务。在这些地方,请用腾讯 WorkBuddy、千问办公这类国产桌面助手,加一个 Portaxo 访问令牌接入,步骤在本页的“其他应用”里。
接入 AI 助手要额外收费吗?
接入本身不收费。工具花的是你组织的积分,规则和网页版完全一样:检索时(按产品或按公司名)每新解锁一家公司或供应商 1 积分,解锁联系人每家公司 5 积分(没找到新人时 1 积分;电话包含在内),账户、联系人、活动和进度这几个工具都免费。
AI 会不会不经我同意就把邮件发出去?
只有 launch_campaign 会发邮件,草稿永远不会自己发出。调用工具前会不会先问你,要看你用的助手:Claude 除非你给某个工具选了“始终允许”,否则每次都会先问;其他助手做法不一,有的会直接调用、不再问你。请在你的助手里检查审批设置,让 launch_campaign 保持“需要确认”。邮件发出后无法撤回;pause_campaign 能拦住还没发出去的部分。
需要哪个套餐?
任何套餐都能接入,get_account 和 find_company 在所有套餐上都能用(免费版上 find_company 每次最多 5 家,每天 5 次)。但免费版既没有“品类检索”,也没有“开发信”功能:在免费版上,按产品找买家和找供应商的工具(find_buyers、find_suppliers)、find_contacts,以及七个活动工具(create_campaign、update_campaign、add_recipients、remove_recipients、launch_campaign、pause_campaign、campaign_status)都会返回 PLAN_UPGRADE_REQUIRED。
怎么断开连接?
在 Portaxo 里打开 账户设置 → API 与 MCP → 已连接的应用,点“断开”;令牌在同一页的“访问令牌”里撤销。修改或重置密码、或者点“全部退出”,会一次性断开所有应用、撤销所有令牌。