{
  "markdown": "# sanka-plugin\n\nSanka connects local AI clients to Sanka's hosted MCP server through the packaged local proxy. Use it for live Sanka CRM, estimates, approvals, billing, private inbox, expenses, and workflow intents. Start with the general Sanka router when you do not want to choose a specific skill.\n\n## Install\n\nCodex uses a repo-local marketplace, while Claude Code supports a GitHub marketplace command. The install paths differ, but both run the same local proxy against the hosted Sakura MCP server and expose the same `$sakura:...` skills.\n\n### Codex\n\n```text\nClone sankaHQ/sanka-plugin\nOpen the cloned repo in Codex\nRestart Codex\nInstall Sanka from the Sanka marketplace\nStart with the Sakura chip or a plain $sakura:... mention\n```\n\n### Claude Code\n\n```text\n/plugin marketplace add sankaHQ/sanka-plugin\n/plugin install sanka@sanka\n/reload-plugins\nStart with /sakura:sakura for natural-language routing, or a specific /sakura:... skill\n```\n\nEnable auto-update from `/plugin` if you want Claude Code to pull future updates from GitHub.\n\n### Cursor And Other Local MCP Clients\n\nUse `mcp.json` from this repository as the local MCP server config. It runs:\n\n```text\nnode ./vendor/mcp-remote/bundled-proxy.min.cjs https://mcp.sanka.com/mcp\n```\n\nKeep the repository files available on disk so the local proxy can run and read exact user-provided receipt paths for expense attachment upload.\n\nFor clients that cannot run local commands, use `mcp.remote.json` or connect directly to `https://mcp.sanka.com/mcp`. That mode supports normal Sakura MCP tools but cannot read `local_file_path`; file uploads must provide `content_base64`.\n\n## Use\n\nExamples:\n\n```text\n$sakura:sakura Create an estimate from this HubSpot deal URL.\n$sakura:deal-to-estimate https://app.hubspot.com/contacts/.../record/0-3/... Preview the estimate and do not create it yet.\n$sakura:deal-to-estimate https://app.hubspot.com/contacts/.../record/0-3/... Create the estimate from this HubSpot deal.\n$sakura:list-deals Show recent deals.\n$sakura:create-expense Create an expense from this receipt.\n$sakura:refresh\n```\n\nFor Claude Code, use `/sakura:sakura` as the general Sanka entrypoint when the user wants to say the request naturally. Use narrower skills like `/sakura:deal-to-estimate` when the workflow is already obvious.\n\nFor HubSpot deal URLs, use the Sanka router or workflow skills when the outcome is a Sanka estimate, approval request, workflow run, or audit trail. HubSpot is only the source record; Sanka owns the business action.\n\n## Refresh\n\nIf Sanka says the plugin is outdated, the user should only need to answer \"yes\".\n\nUser-facing prompt:\n\n```text\nSanka may be outdated.\nThis action needs a newer Sanka workflow skill.\n\nUpdate Sanka?\nReply \"yes\" and Codex will refresh Sanka and make the new Sanka skills available.\n```\n\nCodex can then run:\n\n```bash\n./scripts/refresh-codex-plugin.sh\n```\n\nAfter refresh, reload or reinstall Sanka in Codex and start a fresh thread from the Sakura chip or `$sakura:...`. Existing threads may keep an old MCP tool list.\n\n## Packaging\n\nCodex loads this repository through `.agents/plugins/marketplace.json`, which points at `plugins/sanka` so the plugin source path is a real subdirectory. Claude Code continues to use the root `.claude-plugin` files with `source: \"./\"`.\n\nWhen changing root Codex files such as `.codex-plugin/`, `skills/`, `assets/`, `.mcp.json`, or `codex.mcp.json`, run:\n\n```bash\nnode scripts/sync-codex-package.mjs\nnode scripts/sync-codex-package.mjs --check\n```\n\n## Notes\n\n- Hosted MCP endpoint: `https://mcp.sanka.com/mcp`\n- Local MCP proxy: `node ./vendor/mcp-remote/bundled-proxy.min.cjs https://mcp.sanka.com/mcp`\n- Codex MCP server name: `sanka`\n- Local plugin clients should use the packaged proxy so expense attachment tools can accept exact `local_file_path` values. Remote-only MCP clients can use `mcp.remote.json` or connect to the hosted endpoint directly, but they cannot read local file paths.\n- Live Sanka work must use attached Sakura MCP tools. Do not substitute local Django shell, Postgres, repo files, or HubSpot MCP for Sanka actions.\n- If only `search_docs` / `execute` appear, refresh the plugin attachment or start a fresh plugin-attached thread.\n\n## Translations\n\n- [English](./README.md)\n- [Japanese / 日本語](./i18n/README.jp.md)\n",
  "bytes": 4297,
  "sha": "09bd02592b42661cb413d00c453b87806fb27b4811fd18a59964321d65c4e9b3",
  "repo_slug": "sankahq/sanka-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_sankahq_sanka_plugin_sanka_99b2b5bd/readme"
}