ManaWG

ManaWG MCP

AI アシスタントのためのシェアフラット：ManaWGの支出、残高、掃除当番表、買い物リスト、備品、掲示板、チャット、カレンダーを、 Claude、ChatGPT、Cursor、その他すべての MCP クライアント向けのツールとして利用できます。

エージェントを接続 · ツール · セルフホスト · 仕組み · 貢献する

ManaWGは、シェアフラット（ドイツ語のWohngemeinschaftに由来するWG）向けの無料のオープンソースアプリです。このサーバーを使うと、アシスタントがアプリ上で行うのと同じように、あなたのフラットの用事をこなせます。期限が来ているものを確認し、支払った費用を記録し、牛乳を買い物リストに追加し、誰が誰に借りがあるかを知らせます。

エージェントを接続

ホスト型サーバー https://mcp.manawg.com/mcp を使用してください。クライアントがブラウザーを開くので、ManaWG にサインインしてアシスタントを許可します。コピーするキーも、インストールするものもありません。

クライアント	追加方法
Claude Code	claude mcp add --transport http manawg https://mcp.manawg.com/mcp
Claude（ウェブ、デスクトップ）	Settings → Connectors → Add custom connector、URL は https://mcp.manawg.com/mcp
ChatGPT	Settings → Apps & Connectors → Advanced settings → Developer mode を開き、URL と OAuth を使って Create を選択します
Cursor、VS Code、その他	URL https://mcp.manawg.com/mcp を指定して、ストリーミング可能な HTTP サーバーを追加します

ManaWG アカウントをまだお持ちでない場合は、app.manawg.comでアカウントとフラットを作成してください。または、サインイン後にアシスタントから wg_create を呼び出すこともできます。

こんなことを頼めます

• 「今週、フラットで期限が来ているものは何ですか？」
• 「食料品に42.80 €を支払いました。Jonas 以外の全員で分けてください。」
• 「誰が誰に借りがありますか？精算に必要な支払い回数が最も少なくなる方法は？」
• 「オーツミルクと食器用洗剤を買い物リストに追加してください。」
• 「12日から19日まで留守にするので、掃除当番表から外してください。」
• 「未精算の残高について、感じのよいリマインダーを書いてください。ただし送信はしないでください。」

アシスタントにできること

アシスタントは、アプリでのあなたと同じ権限で、すべてのフラットにおけるあなたのアカウントとして動作します。

• できること：あなたが見られるものをすべて読み取り、支出、固定費、買い物アイテム、備品、家事、投稿、チャットメッセージ、イベント、欠席を作成・編集し、アプリと同じ方法で債務を精算できます。
• できないこと：フラットの削除、アカウントやサインインの変更、または送金はできません。ManaWG が送金することはありません。精算では、お互いに支払った金額を記録するだけです。
• ホスト型サーバーでは、破壊的なツールを16個すべて除外しています：支出、投稿、アイテムの削除、フラットやメンバーの設定変更、リマインダーの送信、インポートの確定などです。読み取りツールには readOnlyHint が付いているため、クライアントはその他の各呼び出しの前に確認できます。
• 管理権限は常にあなたにあります。 接続したアシスタントはすべて、アプリの「設定 → アクセス」に一覧表示され、そこから個別に接続を解除できます。

74個のツール、13個のリソース、4個のプロンプトの全一覧は、docs/tools.md をご覧ください。

領域	例
概要	wg_overview、dashboard_get、activity_get、export_get
お金	expense_create、balances_get、settlement_preview、cash_payment_record
固定費	recurring_list、recurring_create、recurring_advance
買い物と備品	shopping_add、shopping_set_bought、inventory_consume
掃除当番	chores_list、chore_complete、absence_create
掲示板とチャット	note_create、note_comment、chat_send、chat_unread
カレンダー	events_list、event_create、event_update
プロンプト	daily_brief、shopping_run、payment_reminder、settlement_plan

動作の仕組み

sequenceDiagram
    autonumber
    participant C as MCP client
    participant M as mcp.manawg.com
    participant S as Supabase Auth
    participant A as app.manawg.com
    C->>M: POST /mcp
    M-->>C: 401 + protected resource metadata
    C->>S: register client, start sign-in (PKCE)
    S->>A: consent page
    A-->>S: user signs in and allows
    S-->>C: access token
    C->>M: POST /mcp with bearer token
    M->>M: verify token against the JWKS
    M->>A: same call to the app API, with the token
    A-->>M: data, checked against your membership
    M-->>C: tool result

このサーバーは、MCP 認可仕様に記載されている OAuth 2.1 リソースサーバーです。アプリのサインインにすでに使われている Supabase Auth が認可サーバーです。MCP サーバーは何も保存しません。各トークンを検証して転送し、アプリはスマートフォンの場合と同じメンバーシップ確認を適用します。

各ツールは、アプリ API のルートを1つだけ呼び出します。金額は整数のセント単位で扱われ、書き込みにはすべて冪等性キーが付くため、リクエストを再試行しても二重に記帳されることはありません。また、フラットメイトと競合する可能性のある書き込みは上書きせず失敗します（chore_occurrence_changed、shopping_item_changed）。エラーは ManaWG request failed: splits_sum_mismatch のような固定コードで返され、上流のテキストや認証情報が返されることはありません。

セルフホスト

ローカルエージェント向けに stdio で、API キーを使った HTTP 経由で、または独自の ManaWG インスタンスの前段に独自の OAuth サーバーを置いて、自分のマシンで実行できます。

git clone https://github.com/Abuarchiv/manawg-mcp.git && cd manawg-mcp
pnpm install && pnpm build
mkdir -p ~/.config/manawg-mcp && cp .env.example ~/.config/manawg-mcp/env
chmod 600 ~/.config/manawg-mcp/env        # then fill in your instance and account
claude mcp add manawg --env-file ~/.config/manawg-mcp/env -- node "$(pwd)/dist/index.js"

または Docker を使用します：ghcr.io/abuarchiv/manawg-mcp（linux/amd64、linux/arm64）。

セルフホストガイドでは、2つの認証方式、すべての環境変数、HTTP トランスポート、Docker、および mcp.manawg.com を使った Vercel へのデプロイについて説明しています。

開発

Node.js 22 と pnpm 9 が必要です。テスト、lint、型チェックに認証情報は必要ありません。

pnpm lint        # Biome
pnpm typecheck   # tsc --noEmit
pnpm test        # Vitest: flows against a stateful stub app, API surface, OAuth
pnpm build       # compile to dist/
pnpm smoke       # stdio handshake against dist/
pnpm inspector   # MCP Inspector against dist/index.js
pnpm live-check  # read-only probes against a real instance (credentials required)

テストでは、アプリのルール（Origin、Cookie、冪等性キー、楽観的ロック、厳格なリクエストボディ）を適用するアプリのスタブに対して、実際のサーバー、クライアント、セッションのコードを実行します。また、API サーフェスのチェックによって、すべてのツールが実際にアプリに存在するルートに対応していることを確認します。

貢献

Issue とプルリクエストを歓迎します。まず CONTRIBUTING.md と Code of Conduct をお読みください。アプリ自体の問題は、アプリのリポジトリで報告してください。セキュリティ上の問題は非公開で報告してください。詳しくは SECURITY.md をご覧ください。変更内容は CHANGELOG.md に記載しています。

ライセンス

Apache License 2.0 です。ManaWG アプリと同じライセンスです。このライセンスは、ManaWG の名称やロゴに対する権利を付与するものではありません。