mcp-malt

Malt API용 MCP 서버입니다. Malt가 게시한 13개 작업 전체를 다룹니다. 고객에게 발행한 인보이스, Malt가 청구하는 수수료, 받은 지급, 그리고 조직 계정에 대한 SCIM 사용자 프로비저닝을 포함합니다.

이 서버가 다루는 것과 다루지 않는 것

Malt의 API는 대부분의 예상보다 그 범위가 작습니다. 백오피스 청구와 엔터프라이즈 사용자 프로비저닝을 다루며, 그 외에는 아무것도 다루지 않습니다.

프로필 검색, 프로필, 미션, 제안, 메시징은 없습니다. 그것들이 Malt이 잘 알려진 기능이지만, 그중 어떤 것도 공개 API에 없습니다. 그런 기능이 목적이라면 이 서버는 아무것도, 문서화된 API 위에 구축된 다른 어떤 것도 제공할 수 없습니다.

Malt용 커뮤니티 MCP 서버 두 개는 브라우저 자동화로 웹 앱을 제어하고 DOM을 스크래핑하여 그 데이터에 접근합니다. 해당 서버의 자체 문서에는 프로필 편집을 자동화하려면 Malt의 서비스 약관을 위반할 수 있다는 경고가 있습니다. 이 서버는 문서화된 API만 호출합니다.

Related MCP server: fintaro-mcp

토큰 받기

1. 아직 계정이 없다면 signup 페이지에서 신원 정보를 만듭니다.

2. My Account, API Keys를 엽니다.

3. 필요한 권한 범위로 액세스 토큰을 만듭니다. 사용하려는 Toolset에 맞춰 설정하세요.

4. 토큰은 즉시 복사하세요. 토큰은 생성 시 한 번만 표시되고 다시는 보이지 않습니다.

프리랜서 계정 토큰은 셀프 서비스로 발급받습니다. scim 상품셋에 필요한 클라이언트 팀 및 조직 계정 토큰은 Malt 담당자를 통해 받습니다.

여기에는 OAuth 2.0이 없습니다. Malt은 권한 부여 서버와 토큰 엔드포인트를 게시하지 않으므로 위의 API 토큰이 유일한 접근 방식입니다. docs/authentication.md에 많은 사람들이 막히는 헤더 세부까지 포함하여 더 자세히 설명되어 있습니다.

설치

하나의 릴리스에서 세 가지로 게시됩니다. npmjs 및 GitHub Packages의 npm 패키지와 GHCR의 컨테이너 이미지입니다. npx가 일반적 MCP 클라이언트에서 선택되며, Docker는 잠긴 환경이나 공유 설정에 적합합니다.

npm를 대신해 GitHub Packages에서 설치하려면 해당 레지스트리를 scope로 지정해야 합니다. .npmrc에 @ialejandro:registry=https://npm.pkg.github.com을 설정하세요.

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가 없으면 서버는 시작되고도 아무것도 제공하지 않습니다. 이는 오류가 아니라 의도한 동작입니다. 모델이 무엇을 볼 수 있을지는 사용자가 지정합니다. 도구들을 한 번에 하나씩 추가하세요.

알 수 없는 도구세트 이름은 무시되지 않고 오류와 함께 서버를 중지합니다. 오타로 조용히 세 가지 도구셋을 잃으면 디버깅하기 매우 힘들기 때문입니다.

일반적인 작업

분기 정산. invoices,payments,fee-invoices를 활성화하고 malt_reconcile_revenue 프롬프트를 실행합니다. 세 목록을 모두 가져와 결제를 정산 인보이스와 매칭하고, 총 청구액, 세금, Malt의 수수료, 받은 현금을 보고합니다.

내 Malt 수익을 2026년 1분기 기준으로 정산해 줘.

인보이스 PDF 받기. Malt은 PDF를 JSON 본문에 base64로 인코딩해 반환합니다. 도구들이 이를 디코딩하고 실제 PDF 첨부 파일로 전달합니다.

인보고서 INV-123456의 PDF를 내려받아 줘.

퇴사 처리하기. MALT_ALLOW_WRITES=true로 scim을 활성화하고 malt_user_lifecycle을 사용하세요. 이 도구는 삭제가 아니라 비활성화하는 방식으로, 이 방식이 Malt이 실제로 지원하는 길입니다.

jane.doe@acme.com을 우리 Malt 조직에서 퇴사 처리해 줘.

문서

• 토큰 얻기 및 관리

• 인증, 오류 및 토큰 엔드포인트가 없는 이유

• 도구세트: 무엇을 언제 활성화해야 하는지

• 요청 및 응답을 포함한 모든 엔드포인트

• 오류와 그 의미

• 요청 비율 제한

• 서버 확장

개발

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

테스트는 fetch를 모킹하며 실제 라이브 API를 호출하지 않습니다.

spec/malt-openapi.json은 Malt의 공개 문서를 커밋한 스냅샷입니다. 일일 워크플로가 공개 스펙과 대조하고, 변경이 발생하면 PR을 엽니다. Malt은 항상 info.version을 0.0.1로 유지해 왔으므로, 이 검사는 버전 번호를 신뢰하는 대신 작업 항목을 비교합니다.

기여

CONTRIBUTING.md를 참조하세요. 엔드포인트나 도구세트를 추가하는 방법은 docs/extending.md에 설명어져 있습니다.

라이선스

MIT