mcp-jp — Japanese SMB SaaS connectors

mcp-jp — Japanese SMB SaaS connectors

日本の SMB 向け SaaS に対応した MCP サーバー集

Claude などの AI エージェントから、日本のクラウドサービスを自然言語で操作できるようにします。 公式 MCP が存在しないサービスへのコネクタを独自実装しています。

このリポジトリの狙いと収益化の考え方は 戦略メモ を参照。 その他の詳細ドキュメントは docs/README.md にまとめています。

メンテナンス状況

2026-10-27 から保守モードです。 新しいコネクタの追加は止めていますが、リポジトリは公開したまま維持します。

• CI（テスト）は動かし続けます。 依存ライブラリの破壊的変更などで壊れたら直します。
• 各コネクタの実データでの動作確認は、時間のあるときに1本ずつ進めます。 確認状況は下の一覧の「動作確認」列に書いています。 「未確認」は、公式ドキュメントに沿って実装し、構造とエラー処理のテストは CI で通しているものの、実際のアカウントではまだ動かしていないという意味です。 確認は tests/test_live_smoke.py の LIVE_CASES に1行足して、読み取り専用のツールで疎通を見る方法で行います。
• Issue・PR は歓迎します。返信はベストエフォートです。

---

コネクタ一覧

日本SMB向け（独自実装）

コネクタ	サービス	カテゴリ	動作確認
lstep/	Lステップ	LINE マーケティング	未確認
kingtime/	KING OF TIME	勤怠管理	未確認
smarthr/	SmartHR	人事・労務	未確認
kaonavi/	カオナビ	タレントマネジメント	未確認
cydas/	CYDAS	タレントマネジメント	未確認
mazrica/	Mazrica Sales	SFA	未確認
invox/	invox	受取請求書	未確認
smaregi/	スマレジ	POS・店舗管理	未確認
jobcan-workflow/	ジョブカン経費精算/ワークフロー	経費・ワークフロー	未確認
base-ec/	BASE	EC	未確認
cloudsign/	クラウドサイン	電子契約	未確認
herp/	HERP Hire	採用管理	未確認
talentio/	Talentio	採用管理	未確認
lineworks/	LINE WORKS	ビジネスチャット	未確認
board/	board	経営・請求書管理	実APIと仕様を突き合わせ済み（2026-08）
hrmos-kintai/	HRMOS勤怠	勤怠管理	未確認
misoca/	Misoca	見積・請求書	未確認
makeleaps/	MakeLeaps	請求書・見積書	未確認
notepm/	NotePM	社内wiki	未確認
relation/	Re:lation	CS・メール共有	未確認
karte/	KARTE	MA・CDP	未確認
akashi/	AKASHI / MFクラウド勤怠Plus	勤怠管理	未確認
yappli-crm/	Yappli CRM	モバイルCRM	未確認
payjp/	PAY.JP	決済	未確認

グローバルSaaS（独自実装）

コネクタ	サービス	カテゴリ	動作確認
pipedrive/	Pipedrive	CRM	未確認
freshdesk/	Freshdesk	カスタマーサポート	未確認
trello/	Trello	プロジェクト管理	未確認
toggl/	Toggl Track	時間計測	未確認
harvest/	Harvest	時間計測・請求書	未確認
typeform/	Typeform	フォーム作成	未確認
sendgrid/	SendGrid	メール配信	未確認

公式MCPが提供されているサービス

以下は公式 MCP サーバーが提供されているため、そちらを利用してください。

サービス	公式MCP
freee会計	2026年3月公開（270 API）
マネーフォワードクラウド	2026年3月全プラン開放
kintone	2026年5月公式QSG公開
Chatwork	chatwork/chatwork-mcp-server
Backlog	nulab/backlog-mcp-server
Sansan	2025年11月提供開始
Salesforce	Salesforce Hosted MCP Server（2026年4月 GA）
MiiTel	RevComm（2025年12月 Beta）
SALES GO / GoCoo!	日本初MCPサーバー対応SFA（2025年10月 GA）
カラーミーショップ	リモートMCPサーバー（2026年3月 GA）
zaico	zaico MCP（2026年6月 GA）
Mackerel	mackerelio-labs/mcp-server
電子印鑑GMOサイン	GMO AI Connect（2026年秋 GA予定）
SalesNow	api-data.api.salesnow.jp/v1/mcp
Zendesk	2026年夏 GA予定
HubSpot	mcp.hubspot.com（2026年4月 GA）
Notion	mcp.notion.com
Stripe	mcp.stripe.com
Twilio	Twilio Alpha MCP（Public Beta）
Airtable	2026年2月 GA
GitLab	GitLab Duo MCP（Beta）
Asana	mcp.asana.com V2（2026年2月）
Jira	Atlassian MCP（2026年2月 GA）
Shopify	Storefront/Dev MCP（2026年1月〜）
Mailchimp	Intuit/Anthropic連携（2026年春）
Confluence	Atlassian MCP（2026年2月 GA）
Square	mcp.squareup.com（Beta）
Box	mcp.box.com（2025年8月 GA）
Zoom	Zoom MCP（2026年4月〜）
Dropbox	mcp.dropbox.com（2026年3月 GA）
PagerDuty	PagerDuty/pagerduty-mcp-server
Datadog	datadog-labs/mcp-server（2026年3月 GA）
ClickUp	mcp.clickup.com（Public Beta）
Calendly	mcp.calendly.com
Brevo	mcp.brevo.com
ActiveCampaign	mcp.activecampaign.com
Sentry	getsentry/sentry-mcp
Heroku	heroku/heroku-mcp-server
Cloudflare	cloudflare/mcp-server-cloudflare
Vercel	mcp.vercel.com（2025年8月〜）
CircleCI	CircleCI-Public/mcp-server-circleci
Garoon	garoon/garoon-mcp-server（公式・2026-08-13 確認）
esa	esaio/esa-mcp-server（公式・2026-08-13 確認）
Jooto	PRTIMES/jooto-mcp（提供元 PR TIMES・2026-08-13 確認）
Intercom	intercom/intercom-mcp-server（公式・2026-08-13 確認）

これらのサービスについては、過去に独自実装したコネクタを archive/ に移動し、メンテナンス対象外としています。新規利用では公式 MCP を使ってください。

---

セットアップ

必要なもの

• Python 3.10 以上
• Claude Desktop または MCP 対応クライアント

インストール

各コネクタは独立したパッケージです。使いたいコネクタのディレクトリで pip install -e . を実行します。

# 例: SmartHR コネクタをインストール
cd smarthr
pip install -e .

Claude Desktop への設定

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）を編集します。

{
  "mcpServers": {
    "smarthr": {
      "command": "smarthr-mcp",
      "env": {
        "SMARTHR_CLIENT_ID": "your_client_id",
        "SMARTHR_CLIENT_SECRET": "your_client_secret", # pragma: allowlist secret
        "SMARTHR_SUBDOMAIN": "your_subdomain"
      }
    }
  }
}

各コネクタの詳細なセットアップ手順・必要な環境変数は、各ディレクトリの README.md を参照してください。

---

構造

各コネクタは以下の構成で統一されています。

{connector}/
├── pyproject.toml          # パッケージ設定
├── README.md               # セットアップ手順・ツール一覧
└── src/{connector}_mcp/
    ├── __init__.py
    ├── _http.py            # 共通ヘルパー（レスポンス整形・エラー処理）
    └── server.py           # MCP サーバー実装

_http.py は全コネクタ共通（外部依存を増やさないため各パッケージに同梱）。 API エラーは生のスタックトレースではなく原因と対処を示すメッセージに変換し、 大きすぎるレスポンスは LLM のコンテキストを溢れさせないよう切り詰める。

公式 MCP が提供されたサービスのコネクタは archive/ に退避している。

---

コントリビュート

新しいコネクタのリクエストや PR を歓迎します。

「このSaaSを繋ぎたい」だけでも歓迎です — コネクタのリクエストはこちら。非エンジニアの方は note のコメントからでも構いません。需要として記録し、重なっているものから優先して実装します。

コネクタ追加の前に:

• 候補選定マトリクスでスコアリングしてから着手してください（公式MCP不在の持続性・需要・検証可能性・日本SMB密着度）
• 対象サービスの公式 MCP が存在しないか確認してください（公式MCP一覧を参照）。既にある場合は作らない
• 公開された REST API ドキュメントが存在し、テスト用クレデンシャルを取得できることを確認してください

実装のガイドライン:

• 1 コネクタあたり 5 つ前後のツールを実装する
• 認証情報は環境変数で渡す
• レスポンス整形・エラー処理は共通ヘルパー _http.py（format_response / error_response）を使う
• 各コネクタに README.md（セットアップ手順・ツール一覧・使用例）を含める
• 既存のコネクタ（例: payjp/）を参考にパターンを合わせる

---

ライセンス

MIT License