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 里也都能用。

01

打开预填好的窗口

如果 Claude 要求登录,先登录。

添加到 Claude
02

保持默认,点 Add,再点 Connect

“Sign in now”和“Register automatically (DCR)”保持默认不动。先点 Add,再点 Connect。

03

在 Portaxo 页面上批准

浏览器会打开 Portaxo。需要的话先登录,确认页面上显示的是你想让助手使用的那个账户,然后点 批准。

04

在对话里打开它

在对话里点 + → 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 里登录。

01

添加服务器

在终端里运行:

claude mcp add --transport http portaxo https://api.portaxo.com/mcp

这样加的 Portaxo,只在你当前这个文件夹里运行 Claude Code 时才有。想在所有项目里都能用,在 claude mcp add 后面加上 --scope user。

02

在 Claude Code 里登录

启动 Claude Code,运行 /mcp,选 portaxo,再选 Authenticate。浏览器会打开 Portaxo:需要的话先登录,确认显示的账户没错,然后点 批准。

03

确认已经连上

再运行一次 /mcp,portaxo 会显示为已连接(connected)。然后问一句“看看我的 Portaxo 账户”。

  • 已经在 claude.ai 上加过?Claude Code 登录的是同一个 Claude 账户时,你在 claude.ai 上加的连接器也会出现在它的 /mcp 列表里,不运行上面的命令,Portaxo 可能也已经在了。

这台机器打不开浏览器

在服务器上,或者任何打不开浏览器登录的地方,改用访问令牌接入。把 TOKEN 换成你的令牌,Bearer 和它后面的空格要保留。

Claude Code,用访问令牌
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)

01

添加服务器

在终端里运行。Codex 会自己找到 Portaxo 的登录入口,并打开浏览器。

codex mcp add portaxo --url https://api.portaxo.com/mcp
02

在 Portaxo 页面上批准

需要的话先登录,确认显示的是你想让 Codex 使用的那个账户,然后点 批准。登录状态由 Codex 自己保存、自己续期。

03

确认已经连上

启动 Codex,运行 /mcp,能看到 portaxo 和它的工具。然后问一句“看看我的 Portaxo 账户”。如果浏览器没有打开,或者你之前断开过 Codex,用这条重新登录:

codex mcp login portaxo

Codex 桌面版和 IDE 插件

已经在命令行里加过了?桌面版和插件读的是同一个配置文件,Portaxo 已经在列表里,提示时点 Authenticate 就行。没加过的话,按下面的步骤加。不同版本的菜单名称可能略有不同。

Codex 桌面版

  1. 打开 Settings → MCP servers → Add server。
  2. 名称填 portaxo,选择 Streamable HTTP,填入服务器地址 https://api.portaxo.com/mcp。
  3. 点 Save,再点 Restart。
  4. 点 Authenticate,到 Portaxo 页面上批准。

Codex IDE 插件(VS Code、Cursor)

  1. 在 Codex 面板里点齿轮图标,再打开 MCP servers → Add server。
  2. 填同样的内容:名称 portaxo,选 Streamable HTTP,填入服务器地址。
  3. 保存,然后点 Restart extension。
  4. 点 Authenticate,到 Portaxo 页面上批准。

这台机器打不开浏览器

适合服务器,或者打不开浏览器登录的机器:给 Codex 命令行一个访问令牌。Codex 每次启动都会从环境变量 PORTAXO_TOKEN 里读令牌,所以要把它设在长期有效的地方,再新开一个终端。只在当前终端里 export 一次,换个终端就没了,Codex 会被拒绝。

macOS 或 Linux:加到 ~/.zshrc 或 ~/.bashrc 里
export PORTAXO_TOKEN=TOKEN
Windows:运行一次即可
setx PORTAXO_TOKEN TOKEN
然后在新开的终端里运行
codex mcp add portaxo --url https://api.portaxo.com/mcp --bearer-token-env-var PORTAXO_TOKEN

其他应用

添加到其他应用

ChatGPT 和 Claude、Codex 一样,在浏览器里登录。WorkBuddy、千问办公、豆包、Cursor、VS Code,以及其他支持 MCP 的助手,都用个人访问令牌接入;在中国大陆、香港、澳门,走的也是这条路。

ChatGPT

01

新建自定义 MCP 服务器

打开 chatgpt.com/plugins,点 +,选 Create custom MCP server。

02

填好 Portaxo

名称:Portaxo。地址:服务器地址 https://api.portaxo.com/mcp。认证方式:OAuth。

03

在 Portaxo 页面上批准

创建之后登录 Portaxo,点 批准。

  • 哪些 ChatGPT 套餐能使用会改动数据的工具(比如解锁联系人、启动活动),OpenAI 自己的文档说法不一。如果你的套餐用不了,请改用 Claude 或 Codex。

WorkBuddy、千问办公、豆包、Cursor、VS Code:用访问令牌接入

Claude、Codex 和 ChatGPT 不在中国大陆、香港、澳门提供服务。在这些地方,用国产桌面助手加一个 Portaxo 访问令牌接入就行,Cursor 和 VS Code 也走这条路。令牌就等于你本人:能花积分,也能发邮件,请像保管密码一样保管它。

01

在 Portaxo 里创建令牌

打开 账户设置 → API 与 MCP → 访问令牌,或者 App 里“文档”中的 AI 助手指南。按要用的助手给令牌起名(比如“WorkBuddy”),创建后马上复制:它以 ptx_ 开头,只显示这一次。

02

把配置粘进助手

在下面找到你用的助手,复制配置,把 TOKEN 换成你的令牌。Bearer 和它后面的空格要保留。

03

先问一句不花钱的

“看看我的 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 TOKEN

Cursor

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_accountPortaxo 账户 当前连接的是谁、组织还剩多少积分、每一步的价格、你的发信邮箱,以及最近的活动。免费始终允许
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、千问办公这类国产桌面助手,加访问令牌接入。

第一句话问什么

八句可以直接拿来问的话

先做一次不花钱的账户检查;花积分之前先看结果;任何邮件发出去之前,先看草稿。进口商检索之后的解锁联系人、写草稿和启动活动,针对的是它找到的美国买家;介绍新目录的那封邮件,发给你联系人里已有的人;找海外工厂是为了找货源。

  1. “看看我的 Portaxo 账户” 免费。确认连接通了,顺便看看还有多少积分。
  2. “帮我找 20 家美国的卷尺进口商” 最多 20 积分,先冻结,按新解锁的公司结算。
  3. “解锁前 5 家公司的采购联系人,最多花 30 积分” 指进口商检索结果里排在前面的 5 家美国买家。有新联系人的公司每家 5 积分,上限你说了算。
  4. “给这些联系人写一个 3 封邮件的开发信序列,先给我看草稿” 免费。只存草稿,不会发出。
  5. “启动这个活动” 会从你的邮箱真实发出邮件。
  6. “这个活动有人回复吗?” 免费。
  7. “给联系人里标签是展会的所有人写一封邮件草稿,介绍我们的新产品目录” 免费。给你已有的联系人写一封邮件,只存草稿,不会发出。
  8. “找出口卷尺到美国的海外工厂” 每家新解锁的供应商 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 → 已连接的应用,点“断开”;令牌在同一页的“访问令牌”里撤销。修改或重置密码、或者点“全部退出”,会一次性断开所有应用、撤销所有令牌。

还在犹豫?

让 AI 先替你把 Portaxo 讲一遍。

打开一个已经写好的提问,指向 portaxo.com——你自己看得明白,AI 也顺便知道了这个产品存在。