Skip to content

v0.3.0 — MCPB drag-drop + in-chat auth

Choose a tag to compare

View all tags
@Donatoni Donatoni released this 02 May 21:18
v0.3.0
5723753

Highlights

  • Drag-drop install for Claude Desktop. Download the .mcpb artifact attached to this release, drag it into Settings → Extensions, fill in App ID + Secret in the config tab, then ask Claude “log me into Accela” — no terminal needed.
  • In-chat auth recovery. Two new tools (accela_auth_status, accela_login) are always available, even when no tokens exist or the refresh window has expired. The OAuth flow runs from inside the MCP process.
  • Auto-pagination on search tools. accela_search_records, accela_get_my_records, accela_search_addresses, accela_search_contacts, and accela_search_professionals now return up to 1000 results by default and surface a continuation cursor when more are available, so a year-long records query no longer silently stops at 100.

Added

  • auth capability group (always-on) — accela_auth_status, accela_login. The login tool opens the browser, captures the OAuth redirect on a loopback listener, persists encrypted tokens, and auto-creates capabilities.yaml on first login.
  • Bootstrap mode in serve_async — when tokens are missing or the refresh window has lapsed, the server registers only the auth tools instead of failing to start.
  • ensure_mcp_key() auto-generates a Fernet encryption key on first run when the host passes an empty value, persisting it to the user-level env file (mode 0600 on Unix).
  • 401-after-refresh API errors include a hint pointing at accela_login so the model can self-suggest the fix.
  • manifest.json, bundle/server/launcher.py, bundle/icon.png, scripts/build-mcpb.sh, and .github/workflows/release-mcpb.yml so each Release attaches a packed .mcpb.
  • auto_paginate=True (default) and max_results=1000 on the search tools, with a structured continuation cursor when capped. Set auto_paginate=False for the previous single-page behavior.
  • auto_paginate_collect helper in api/pagination.py for tool authors.
  • docs/INSTALL.md covering all four install paths (Claude Desktop drag-drop, accela-mcp setup CLI, manual Codex, manual Cursor / stdio).

Changed

  • tools/_base.tool_call adds the login hint for status 401, alongside the existing EMSE hint for status 500.
  • default_capabilities_yaml moved from cli.py into capabilities.py so the CLI and the in-chat login path share one default.

Install

  • Claude Desktop: download accela-mcp-0.3.0.mcpb below and drag it into Settings → Extensions.
  • CLI (Codex / Claude Desktop / Cursor): uv tool install accela-mcp then accela-mcp setup.

Full install walkthrough: docs/INSTALL.md.

Assets 3
Loading