mcp-jp — Japanese SMB SaaS connectors

mcp-jp — 日本 SMB SaaS 连接器

面向日本 SMB 的 SaaS MCP 服务集合

让 Claude 等 AI Agent 能够通过自然语言操作日本云服务。 我们为尚无官方 MCP 的服务独立实现了连接器。

有关本仓库的目标和变现思路，请参阅战略备忘录。 其他详细文档汇总在 docs/README.md。

维护状态

自 2026-10-27 起进入维护模式。 我们已停止添加新连接器，但会继续公开维护本仓库。

• CI（测试）会继续运行。 如果因依赖库的破坏性变更等原因导致故障，我们会进行修复。
• 有空时会逐个使用各连接器的真实数据进行验证。 验证状态记录在下方列表的“运行验证”列中。 “未验证”表示已根据官方文档完成实现，结构和错误处理测试也已通过 CI，但尚未在实际账号中运行。 验证方式是在 tests/test_live_smoke.py 的 LIVE_CASES 中添加一行，并使用只读工具检查连接情况。
• 欢迎提交 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	电商	未验证
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	客户支持与邮件共享	未验证
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 错误不会以原始堆栈跟踪的形式呈现，而会转换为说明原因和处理方法的消息； 过大的响应会被截断，以免超出大模型的上下文限制。

已提供官方 MCP 的服务，其连接器已移至 archive/。

---

コントリビュート

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

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

コネクタ追加の前に:

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

実装のガイドライン:

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

---

ライセンス

MIT License