mcp-tiny

@codespar/mcp-tiny

Tiny ERP 向け MCP サーバー — 商品、注文、連絡先、請求書、在庫、買掛金

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "tiny": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-tiny"],
      "env": {
        "TINY_API_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

claude mcp add tiny -- npx @codespar/mcp-tiny

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します：

{
  "servers": {
    "tiny": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-tiny"],
      "env": {
        "TINY_API_TOKEN": "your-token"
      }
    }
  }
}

ツール（21）

ツール	用途
list_products	Tiny ERP の商品一覧を取得
get_product	ID を指定して商品の詳細を取得
list_orders	Tiny ERP の販売注文一覧を取得
get_order	ID を指定して注文の詳細を取得
list_contacts	Tiny ERP の連絡先一覧を取得
get_contact	ID を指定して連絡先の詳細を取得
create_invoice	Tiny の注文から税務請求書（NF-e）を作成
get_invoice	ID を指定して請求書の詳細を取得
get_stock	商品の現在の在庫を取得
list_accounts_payable	Tiny ERP の買掛金一覧を取得
update_stock	商品の在庫数を更新（調整） — 保管場所の数量を加算または減算
list_categories	Tiny ERP の商品カテゴリをツリー形式で取得
list_warehouses	Tiny ERP に設定された在庫倉庫（depósitos）の一覧を取得
list_price_lists	Tiny ERP に設定された価格表（listas de preços）の一覧を取得
update_order_status	販売注文のステータスを変更 — キャンセル、承認済みまたは請求済みへの変更に便利
list_invoices	Tiny ERP の税務請求書（NF-e/NFC-e）一覧を取得
get_invoice_xml	発行済み請求書（NF-e）の XML ペイロードを取得
get_invoice_link	発行済み請求書の DANFE PDF／リンクを取得
send_invoice_email	発行済み請求書を宛先にメールで送信
list_accounts_receivable	Tiny ERP の売掛金一覧を取得
get_account_receivable	ID を指定して売掛金レコードを取得

認証

Tiny では、各リクエストで渡すトークンパラメーターを使用します。

サンドボックス／テスト

Tiny では、アカウント登録を通じてテストアクセスを利用できます。

認証情報を取得する

1. Tiny ERP にアクセスします
2. アカウントを作成します
3. API 設定に移動してトークンを生成します
4. TINY_API_TOKEN 環境変数を設定します

環境変数

変数	必須	説明
TINY_API_TOKEN	はい	Tiny ERP の API トークン

ロードマップ

v0.2（予定）

• create_product — 新しい商品を作成
• update_product — 商品の詳細を更新
• create_contact — 連絡先（顧客／仕入先）を作成
• update_contact — 連絡先の詳細を更新
• get_financial_summary — 財務概要レポートを取得

v0.3（予定）

• fiscal_reports — 税務レポート（NF-e、NFS-e）を生成
• multi_company — 複数企業の管理

貢献をご希望ですか？PR を作成するか、ツールをリクエストしてください。

リンク

• Tiny ERP ウェブサイト
• Tiny API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT