
thecreativelabs/plutio-mcp
API developmentこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
Model Context Protocol server for Plutio — CRM, projects, invoices, proposals, forms, time tracking & scheduling for Claude and other MCP clients.
概要
A Model Context Protocol (MCP) server for Plutio — the all-in-one business platform for CRM, projects, invoicing, proposals, contracts, forms, time tracking, and scheduling. Gives Claude (and any other MCP client) structured, safe access to via one concise tool per resource. - covering CRM, project management, time tracking, financial, documents, forms, communication, scheduling, knowledge, files, automations, and admin. - (plutio_api_reference, plutio_workspace_schema, plutio_rate_limit_status, plutio_request) for edge cases, workspace introspection, and agent self-orientation. - (plutio_mrr_snapshot, plutio_upcoming_renewals, plutio_invoice_aging, plutio_cashflow_forecast) — single-call reports that replace multi-step manual aggregations. - (plutio_client_360) — fetches a person + their company + projects + invoices + subscriptions in one call.
README
以下は原文 README の抜粋です。原文を見る。
plutio-mcp
A Model Context Protocol (MCP) server for Plutio — the all-in-one business platform for CRM, projects, invoicing, proposals, contracts, forms, time tracking, and scheduling.
Gives Claude (and any other MCP client) structured, safe access to every major resource in your Plutio workspace via one concise tool per resource.
What you get
- 31 resource-group tools covering CRM, project management, time tracking, financial, documents, forms, communication, scheduling, knowledge, files, automations, and admin.
- 4 escape-hatch tools (
plutio_api_reference,plutio_workspace_schema,plutio_rate_limit_status,plutio_request) for edge cases, workspace introspection, and agent self-orientation. - 4 analytics tools (
plutio_mrr_snapshot,plutio_upcoming_renewals,plutio_invoice_aging,plutio_cashflow_forecast) — single-call reports that replace multi-step manual aggregations. - 1 compound lookup tool (
plutio_client_360) — fetches a person + their company + projects + invoices + subscriptions in one call. - 5 MCP resources (
plutio://people/{id},plutio://companies/{id},plutio://projects/{id},plutio://invoices/{id},plutio://tasks/{id}) for clients that support resource browsing. - Read-only by default — no accidental destructive writes until you explicitly enable them.
- OAuth2 with auto-refresh — client-credentials grant; tokens refresh ~1 minute before expiry.
- Built-in rate limiting — a token bucket capped at Plutio’s 1000 req/hr default; requests queue transparently.
- MongoDB-style filtering — pass rich query objects directly (
$or,$regex,$gte, etc.). - Bulk operations for resources that support them.
- Typed end-to-end with Zod → JSON Schema on the wire.
Quick start
1. Install
npm install -g @thecreativelabs/plutio-mcp
# or run without installing:
npx @thecreativelabs/plutio-mcp
2. Get Plutio API credentials
In your Plutio workspace go to Settings → API Manager → Create Connection. You’ll get a Client ID and Client Secret. Copy them — you won’t see the secret again.
3. Configure Claude Desktop / Claude Code
Add to your MCP config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or .mcp.json / .claude/settings.json for Claude Code):
{
"mcpServers": {
"plutio": {
"command": "npx",
インストール
npx -y @thecreativelabs/plutio-mcp設定
{
"mcpServers": {
"plutio": {
"command": "npx",
"args": ["-y", "@thecreativelabs/plutio-mcp"],
"env": {
"PLUTIO_CLIENT_ID": "your_client_id",
"PLUTIO_CLIENT_SECRET": "your_client_secret",
"PLUTIO_BUSINESS": "your_workspace_slug",
"PLUTIO_READ_ONLY": "true"
}
}
}
}