# 安装 io.github.OxygenBubbles/freeagent-mcp-server

- 类型: MCP 工具
- 说明: 通过 FreeAgent MCP 处理银行对账、报销、里程申报与收据管理。
- 仓库: https://github.com/OxygenBubbles/freeagent-mcp-server

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "io.github.OxygenBubbles/freeagent-mcp-server" MCP 服务：
执行：claude mcp add 'io-github-oxygenbubbles-freeagent-mcp-server' -- npx -y @oxygenbubbles/freeagent-mcp-server
```

### Codex
```
请帮我安装 askskill 上的 "io.github.OxygenBubbles/freeagent-mcp-server" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-oxygenbubbles-freeagent-mcp-server]
command = "npx"
args = ["-y","@oxygenbubbles/freeagent-mcp-server"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "io.github.OxygenBubbles/freeagent-mcp-server" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-oxygenbubbles-freeagent-mcp-server": { "command": "npx", "args": ["-y","@oxygenbubbles/freeagent-mcp-server"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env FREEAGENT_CLIENT_ID=YOUR_VALUE --env FREEAGENT_CLIENT_SECRET=YOUR_VALUE --env FREEAGENT_REFRESH_TOKEN=YOUR_VALUE --env VENDOR_CATEGORIES=YOUR_VALUE --env MILEAGE_RATE_PENCE=YOUR_VALUE --env ORS_API_KEY=YOUR_VALUE --env GOOGLE_MAPS_API_KEY=YOUR_VALUE --transport stdio io-github-oxygenbubbles-freeagent-mcp-server -- npx -y @oxygenbubbles/freeagent-mcp-server
```
需要环境变量：FREEAGENT_CLIENT_ID, FREEAGENT_CLIENT_SECRET, FREEAGENT_REFRESH_TOKEN, VENDOR_CATEGORIES, MILEAGE_RATE_PENCE, ORS_API_KEY, GOOGLE_MAPS_API_KEY

### Codex
```bash
codex mcp add --env FREEAGENT_CLIENT_ID=YOUR_VALUE --env FREEAGENT_CLIENT_SECRET=YOUR_VALUE --env FREEAGENT_REFRESH_TOKEN=YOUR_VALUE --env VENDOR_CATEGORIES=YOUR_VALUE --env MILEAGE_RATE_PENCE=YOUR_VALUE --env ORS_API_KEY=YOUR_VALUE --env GOOGLE_MAPS_API_KEY=YOUR_VALUE io-github-oxygenbubbles-freeagent-mcp-server -- npx -y @oxygenbubbles/freeagent-mcp-server
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-oxygenbubbles-freeagent-mcp-server]
command = "npx"
args = ["-y","@oxygenbubbles/freeagent-mcp-server"]

[mcp_servers.io-github-oxygenbubbles-freeagent-mcp-server.env]
FREEAGENT_CLIENT_ID = "YOUR_VALUE"
FREEAGENT_CLIENT_SECRET = "YOUR_VALUE"
FREEAGENT_REFRESH_TOKEN = "YOUR_VALUE"
VENDOR_CATEGORIES = "YOUR_VALUE"
MILEAGE_RATE_PENCE = "YOUR_VALUE"
ORS_API_KEY = "YOUR_VALUE"
GOOGLE_MAPS_API_KEY = "YOUR_VALUE"
```
需要环境变量：FREEAGENT_CLIENT_ID, FREEAGENT_CLIENT_SECRET, FREEAGENT_REFRESH_TOKEN, VENDOR_CATEGORIES, MILEAGE_RATE_PENCE, ORS_API_KEY, GOOGLE_MAPS_API_KEY

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-oxygenbubbles-freeagent-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@oxygenbubbles/freeagent-mcp-server"
      ],
      "env": {
        "FREEAGENT_CLIENT_ID": "YOUR_VALUE",
        "FREEAGENT_CLIENT_SECRET": "YOUR_VALUE",
        "FREEAGENT_REFRESH_TOKEN": "YOUR_VALUE",
        "VENDOR_CATEGORIES": "YOUR_VALUE",
        "MILEAGE_RATE_PENCE": "YOUR_VALUE",
        "ORS_API_KEY": "YOUR_VALUE",
        "GOOGLE_MAPS_API_KEY": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-oxygenbubbles-freeagent-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBveHlnZW5idWJibGVzL2ZyZWVhZ2VudC1tY3Atc2VydmVyIl0sImVudiI6eyJGUkVFQUdFTlRfQ0xJRU5UX0lEIjoiWU9VUl9WQUxVRSIsIkZSRUVBR0VOVF9DTElFTlRfU0VDUkVUIjoiWU9VUl9WQUxVRSIsIkZSRUVBR0VOVF9SRUZSRVNIX1RPS0VOIjoiWU9VUl9WQUxVRSIsIlZFTkRPUl9DQVRFR09SSUVTIjoiWU9VUl9WQUxVRSIsIk1JTEVBR0VfUkFURV9QRU5DRSI6IllPVVJfVkFMVUUiLCJPUlNfQVBJX0tFWSI6IllPVVJfVkFMVUUiLCJHT09HTEVfTUFQU19BUElfS0VZIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：FREEAGENT_CLIENT_ID, FREEAGENT_CLIENT_SECRET, FREEAGENT_REFRESH_TOKEN, VENDOR_CATEGORIES, MILEAGE_RATE_PENCE, ORS_API_KEY, GOOGLE_MAPS_API_KEY