{
  "markdown": "# Mini Accountant — MCP setup\n\nConnect your AI assistant to your [Mini Accountant](https://ad.miniaccountant.app)\nworkspace through our hosted **Model Context Protocol (MCP)** server. No local\nsetup, no API keys — the server is remote and protected by OAuth 2.1, so you sign\nin once with your Mini Accountant account and your assistant acts on your behalf.\n\n- **Server:** `mini-accountant`\n- **Transport:** streamable HTTP\n- **URL:** `https://mcp.miniaccountant.app/v1beta`\n- **Auth:** OAuth 2.1 / OIDC (Authorization Code + PKCE) — you'll be prompted to sign in.\n\n## What you can do\n\nOnce connected, the assistant can:\n\n- **Invoices** — create, read, update, delete; add/update/remove positions and\n  transactions; change the customer on an invoice.\n- **Customers** — create, read, update, delete; set a customer's payment method.\n- **Expenses** — create, read, update, delete; fetch expenses for a period.\n- **Services** — manage your reusable product/service catalogue.\n- **Payment settings** — manage the payment-method documents customers reference.\n- **Analytics** — run reporting queries; get invoices/transactions/expenses for a\n  date range; estimate tax for a period.\n- **Account** — read and update your user profile and app settings.\n\nGuided **skills** and **prompts** (e.g. \"create an invoice\") are also exposed so\nthe assistant discovers the right workflow automatically.\n\n---\n\n## Install in Claude Code (plugin)\n\nThe quickest path — installs the remote server as a plugin, no manual config file.\n\n```\n/plugin marketplace add miniaccountant/mcp-setup\n/plugin install mini-accountant@miniaccountant\n/reload-plugins\n```\n\nThen run `/mcp` and complete the OAuth sign-in when prompted. That's it — the\n`mini-accountant` tools are now available in your session.\n\n> Prefer not to use the marketplace? Add the server directly:\n> ```\n> claude mcp add --transport http mini-accountant https://mcp.miniaccountant.app/v1beta\n> ```\n\n---\n\n## Connect from other clients\n\nSame remote URL, same OAuth sign-in — only the config location differs.\n\n### Claude Desktop / claude.ai connectors\n\nAdd a **custom connector** pointing at the server URL:\n\n1. Open **Settings → Connectors → Add custom connector** (claude.ai) or the\n   equivalent in Claude Desktop.\n2. Name: `Mini Accountant`\n3. URL: `https://mcp.miniaccountant.app/v1beta`\n4. Save, then connect and sign in with your Mini Accountant account when prompted.\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project):\n\n```json\n{\n  \"mcpServers\": {\n    \"mini-accountant\": {\n      \"url\": \"https://mcp.miniaccountant.app/v1beta\"\n    }\n  }\n}\n```\n\nReload Cursor, then authorize the server when Cursor opens the OAuth prompt.\n\n### VS Code (GitHub Copilot / MCP) and other clients\n\nAny client that supports remote/streamable-HTTP MCP servers works with the same\nendpoint. Use the client's HTTP-server form:\n\n```json\n{\n  \"servers\": {\n    \"mini-accountant\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.miniaccountant.app/v1beta\"\n    }\n  }\n}\n```\n\n---\n\n## Authentication\n\nThe server implements OAuth 2.1 / OpenID Connect with:\n\n- Authorization Code grant + **PKCE (S256)**, refresh tokens.\n- Dynamic Client Registration (RFC 7591) — clients register automatically.\n- Discovery documents:\n  - `https://mcp.miniaccountant.app/.well-known/oauth-authorization-server`\n  - `https://mcp.miniaccountant.app/.well-known/oauth-protected-resource`\n  - `https://mcp.miniaccountant.app/.well-known/openid-configuration`\n\nCompliant MCP clients discover these automatically — you only need the server URL.\nTokens are issued to your account; the assistant can only see and change **your**\ndata.\n\n---\n\n## Troubleshooting\n\n- **`401 Unauthorized` / prompted to sign in again** — the access token expired\n  (1h TTL). Re-run the client's connect/authorize action.\n- **Tools don't appear** — confirm the client finished the OAuth flow (in Claude\n  Code, run `/mcp` and check the server shows *connected*).\n- **Wrong workspace** — sign out of the connector and reconnect with the correct\n  Mini Accountant account.\n\n## Support\n\n- Website: https://ad.miniaccountant.app\n- Support: support@miniaccountant.app\n",
  "bytes": 4157,
  "sha": "81c193e547233e34e4abe476ba5331e67832ca1c19306ec35fba294da845d53b",
  "repo_slug": "miniaccountant/mcp-setup",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_app_miniaccountant_mini_accountant_4654d51e/readme"
}