mcp-malt

Malt API 用の MCP サーバーです。Malt が公開している全 13 のオペレーションをカバーします。あなたが発行する請求書、Malt が請求する手数料、受け取る支払い、そして組織アカウントの SCIM ユーザープロビジョニングです。

できることとできないこと

Malt の API は、多くの人が想像するよりも小さいです。扱っているのはバックオフィスの請求処理とエンタープライズ向けユーザープロビジョニングだけで、それ以外はありません。

人材検索、プロフィール、ミッション、オファー、メッセージングはありません。それらは Malt が有名な機能ですが、公開 API には含まれていません。もしこれらを求めてきたのなら、このサーバーは提供できません。ドキュメント化された API を使う他の手段でも同じです。

Malt 向けのコミュニティ製 MCP サーバーは 2 つ、ブラウザ自動化で Web アプリを操作して DOM をスクレイピングすることで、そのデータに到達できます。それらのドキュメントには、プロフィール編集の自動化が Malt の利用規約違反になる可能性があると警告されています。このサーバーはドキュメント化された API のみを呼び出します。

Related MCP server: fintaro-mcp

トークンの取得

1. アカウントを持っていない場合は、サインアップページ でアカウントを作成します。

2. My Account、次に API Keys を開きます。

3. 必要な権限スコープを持つアクセストークンを作成します。有効化するツールセットに合わせてください。

4. トークンをすぐにコピーします。作成時に一度だけ表示され、再び表示されることはありません。

フリーランサーアカウントのトークンはセルフサービスで取得できます。クライアントチームと組織のトークンは scim ツールセットで必要で、Malt の担当者から提供されます。

ここに OAuth 2.0 はありません。Malt は認可サーバーもトークンエンドポイントも公開していないため、上記の API トークンが唯一の入り口です。docs/authentication.md で詳しく説明しています。多くの人がはまるヘッダーの詳細も含まれます。

インストール

1 つのリリースから 3 つの方法で公開しています。npmjs と GitHub Packages 上の npm パッケージ、GHCR 上のコンテナイメージです。npx が通常の MCP クライアントでの選択肢で、Docker はロックダウンや共有の環境に適しています。

npm ではなく GitHub Packages からインストールするには、スコープを指定します。@ialejandro:registry=https://npm.pkg.github.com を ~/.npmrc に追加してください。

npx

// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "malt": {
      "command": "npx",
      "args": ["-y", "@ialejandro/mcp-malt"],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Claude Code

claude mcp add malt \
  --env MALT_API_TOKEN=your-token-here \
  --env MALT_TOOLSETS=invoices,payments,fee-invoices \
  -- npx -y @ialejandro/mcp-malt

Docker

サーバーは stdin/stdout 経由で JSON-RPC を話すため、-i が必要で、-t は付けないでください。

docker run -i --rm \
  -e MALT_API_TOKEN=your-token-here \
  -e MALT_TOOLSETS=invoices \
  ghcr.io/ialejandro/mcp-malt

// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "malt": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MALT_API_TOKEN",
        "-e", "MALT_TOOLSETS",
        "ghcr.io/ialejandro/mcp-malt"
      ],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

ソースからビルド

git clone https://github.com/ialejandro/mcp-malt
cd mcp-malt
npm ci && npm run build

{
  "mcpServers": {
    "malt": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-malt/dist/index.js"],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

{
  "mcpServers": {
    "malt": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MALT_API_TOKEN",
        "-e", "MALT_TOOLSETS",
        "ghcr.io/ialejandro/mcp-malt"
      ],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

設定

MALT_TOOLSETS を設定しない場合、サーバーは起動するものの何も提供しません。これは意図的なもので、失敗ではありません。モデルに見せるものをあなたが決めるのです。ツールセットは 1 つずつ追加してください。

不明なツールセット名は無視されるのではなく、サーバーがエラーで停止します。タイプミスでツールが静かに使えなってしまうのは、デバッグが困難だからです。

よくある操作

四半期を照合する。 invoices,payments,fee-invoices を有効にし、malt_reconcile_revenue プロンプトを実行します。3 つのリストをすべて取得し、支払いを対応する請求書に突き合わせ、売上、税、Malt の手数料、受け取った現金を報告します。

Reconcile my Malt revenue for Q1 2026.

請求書 PDF を取得する。 Malt は PDF を base64 エンコードし JSON に織り込み返します。ツールはそれをデコードし、実際の PDF 添付として返します。

Download the PDF for invoice INV-123456.

社員をオフボードする。 MALT_ALLOW_WRITES=true で scim を有効にし、malt_user_lifecycle を使います。削除ではなく無効化する方式で、Malt は実際にそれをサポートしています。

Offboard jane.doe@acme.com from our Malt organization.

ドキュメント

• トークンの取得と管理

• 認証、そして OAuth がない理由

• ツールセット：いつ何を有効にするか

• エンドポイント一覧、リクエストとレスポンス

• エラーとその意味

• レート制限

• サーバーの拡張

開発

テストは fetch をモックしていて、実際の API を呼びません。

spec/malt-openapi.json は、Malt が公開しているドキュメントのコミット済みスナップショットです。毎日の日次ジョブが実際の仕様と差分を取って、変更があれば PR を作ります。Malt は info.version を 0.0.1 のままにして、いるので、バージョン番号ではなくオペレーション比較します。

npm ci
npm run typecheck
npm test
npm run build
npm run check-spec   # diff the live Malt spec against spec/malt-openapi.json

コントリビューション

CONTRIBUTING.md を参照してください。エンドポイントやツールセットを追加する方法は docs/extending.md にあります。

ライセンス

MIT