使用说明
@代理卡/mcp
给你的人工智能代理一张借记卡。AgentCard允许AI代理创建和使用虚拟借记卡——每张卡都有固定的预算、真实的卡凭证和完整的MCP集成。你的代理人可以创建一张卡,支付东西,检查余额,并自动填写结账表格——而不需要你的个人卡。
快速设置
连接代理的最快方法是通过CLI:
npx agent-cards signup # create an account (one-time)
npx agent-cards setup-mcp # auto-configures Claude Code
就是这样。重新启动Claude Code,工具就可以使用了。
手动设置
HTTP(推荐)
添加到您的MCP客户端配置(Claude Desktop、Cursor等):
{
"mcpServers": {
"agent-cards": {
"url": "https://mcp.agentcard.sh/mcp",
"headers": {
"Authorization": "Bearer <your-jwt>"
}
}
}
}
获取您的JWT npx agent-cards login,然后在中找到它 ~/.agent-cards/config.json.
stdio(本地)
{
"mcpServers": {
"agent-cards": {
"command": "node",
"args": ["/path/to/packages/mcp/dist/src/index.js"],
"env": {
"AGENT_CARDS_JWT": "<your-jwt>",
"AGENT_CARDS_API_URL": "https://your-backend.example.com"
}
}
}
}
工具
| 工具 | 说明 |
|---|---|
list_cards |
列出所有具有余额、到期和状态的虚拟卡 |
create_card |
使用固定的美元预算创建新的虚拟借记卡 |
get_card_details |
获取解密的PAN、CVV、到期(可能需要人工批准) |
check_balance |
无需暴露凭据即可快速进行余额检查 |
close_card |
永久关闭虚拟卡 |
list_transactions |
列出带有可选状态过滤器的卡的交易记录 |
approve_request |
批准或拒绝待处理的人在循环请求 |
submit_user_info |
提交身份信息进行发卡验证 |
setup_payment_method |
设置资金卡的支付方式 |
remove_payment_method |
删除已保存的付款方式 |
pay_checkout |
使用代理卡自动检测并支付结账页面 |
detect_checkout |
检测当前浏览器选项卡上的签出表单 |
fill_card |
在浏览器中的付款表单中填写卡凭据 |
start_support_chat |
开始支持对话 |
send_support_message |
在支持帖子中发送消息 |
read_support_chat |
阅读支持对话历史记录 |
端点
| 方法 | 路径 | 描述 |
|---|---|---|
POST |
/mcp |
MCP可流式HTTP传输 |
GET |
/health |
健康检查({"ok":true}) |
GET |
/.well-known/mcp/server-card.json |
自动发现元数据 |
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
AGENT_CARDS_API_URL |
yes | 后端API URL |
AGENT_CARDS_JWT |
仅限stdio | 用户JWT(HTTP从 Authorization 头球 |
PORT |
no | HTTP服务器端口(默认值: 3002) |
发展
pnpm dev # stdio mode
pnpm dev:http # HTTP mode
pnpm build # compile TypeScript