1. ブラウザで認証URL起動
2. freeeログイン → 認可コード取得
3. アクセストークン取得 → 暗号化保存
4. リフレッシュトークンで自動更新

cp .env.example .env
# .env を編集

FREEE_CLIENT_ID=your_client_id
FREEE_CLIENT_SECRET=your_client_secret
FREEE_REDIRECT_URI=http://localhost:8080/callback
TOKEN_ENCRYPTION_KEY=generate_random_32_bytes
FREEE_COMPANY_ID=your_company_id

python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

pip install -e .

python src/auth.py

python src/server.py

{
  "mcpServers": {
    "freee": {
      "command": "python",
      "args": ["/path/to/freee-mcp/src/server.py"],
      "env": {
        "FREEE_CLIENT_ID": "your_client_id",
        "FREEE_CLIENT_SECRET": "your_client_secret",
        "FREEE_COMPANY_ID": "your_company_id",
        "TOKEN_ENCRYPTION_KEY": "your_encryption_key"
      }
    }
  }
}

/subscription-analyzer

freee-mcp/
├── README.md
├── SETUP.md           # 詳細セットアップガイド
├── LICENSE
├── pyproject.toml
├── .env.example
├── src/
│   ├── __init__.py
│   ├── server.py          # MCPサーバーのメイン
│   ├── auth.py            # OAuth 2.0 PKCE認証
│   ├── token_store.py     # トークン暗号化保存
│   ├── freee_client.py    # freee APIクライアント
│   └── tools.py           # MCPツール定義
├── .claude/skills/
│   └── subscription-analyzer/  # サブスク分析Skill
│       ├── SKILL.md
│       └── patterns.yml
└── tests/
    └── test_integration.py

Claude: freeeの口座明細を取得して、サブスクリプションを確認して

Claude: 2024年度の損益計算書を見せて

Claude: 今日付けで外注費30,000円の取引を作成して