BINKY-WP-0005: Qonto MCP integration — workplan registered, design + DEC-2026-004

- AWQ-010 promoted to workplan BINKY-WP-0005 (hub 6139db83, tasks T01-T05
  registered via fix-consistency C-06); queue item moved to Completed
- integrations/qonto-mcp.md: self-hosted qonto/qonto-mcp-server chosen over
  hosted mcp.qonto.com OAuth connector (no-native-integrations policy);
  OpenBao lane tenants/binky/qonto/api mirroring company-email custody;
  read-only via harness tool allow-list, payments Red lane forever;
  consumers: Finance Steward rhythm, CostRunRate TBC rows, OH-2026-003
- DEC-2026-004 prepared (founder Red lane: API key + bao kv put), hub
  decision a2a9de69

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
tegwick 2026-07-19 14:26:55 +02:00
parent ba4dfeea84
commit 3cfb9f553c
4 changed files with 242 additions and 20 deletions

View file

@ -0,0 +1,98 @@
---
id: BINKY-WP-0005
type: workplan
title: "Qonto MCP integration: bank account as agent-readable finance source"
domain: infotech
repo: binky-control
status: active
owner: codex
topic_slug: the-custodian
created: "2026-07-19"
updated: "2026-07-19"
state_hub_workstream_id: "6139db83-5d4b-4492-a77f-fc9550a0a4f9"
---
Connect the company Qonto account to the agent infrastructure via the
**self-hosted** `qonto/qonto-mcp-server` (API key + organization ID), read
scopes first — **payments/transfers are Red lane forever**. Originates from
AWQ-010 (founder direction 2026-07-18: "integrations like this should help
with the automated company approach a lot" — arrange soon). Credential lane
via ops-warden/OpenBao (`tenants/binky/qonto`), same custody pattern as
company-email (`integrations/company-email-openbao.md`); **no claude.ai
native integrations** — harness/MCP lane only. Main accounting stays DATEV
Unternehmen Online (DUO): Qonto MCP complements, does not replace, the
DUO/StB lane. The working MCP is a substantive argument FOR keeping Qonto
despite plan cost (OH-2026-003).
## Task: Qonto MCP capabilities and docs review
Review the Qonto MCP options (hosted `mcp.qonto.com` OAuth connector vs.
self-hosted `qonto/qonto-mcp-server` with API key), tool surface (read vs.
write), authentication shape, transports, and plan/API prerequisites.
Recommend the variant compatible with the corporate access policy
(harness/MCP lane, no native claude.ai connectors). Output lands in
`integrations/qonto-mcp.md`. Green lane (docs only).
```task
id: BINKY-WP-0005-T01
status: done
priority: high
state_hub_task_id: "e066a222-1608-45ce-96a7-cbf191a39a9b"
```
## Task: Credential lane design — ops-warden/OpenBao custody
Design the OpenBao lane `tenants/binky/qonto` (fields `QONTO_API_KEY`,
`QONTO_ORGANIZATION_ID`), warden catalog entry, and the founder Red-lane
provision procedure — mirroring the company-email-imap pattern. Metadata and
design only; no secret values, provisioning is founder Red lane. Green lane.
```task
id: BINKY-WP-0005-T02
status: done
priority: high
state_hub_task_id: "261e4b34-24a2-4324-950d-881d78333b5d"
```
## Task: Consumer design — rhythm sessions and CostRunRate feeds
Specify how rhythm/finance sessions consume the MCP: real balance and
transaction pulls replace manual Qonto statement pulls; resolve the **TBC**
rows in `finance/CostRunRate.md` (desk rent, Qonto plan cost); feed the
OH-2026-003 cost-vs-usage answer. Read-only tool allow-list at harness
level; write tools (cards, invoicing) stay disabled. Green lane.
```task
id: BINKY-WP-0005-T03
status: done
priority: medium
state_hub_task_id: "6c4a475d-9db7-4488-8563-10c82fa78f51"
```
## Task: DecisionQueue entry for Red-lane provisioning
Prepare the founder approval package: DEC entry covering API key creation in
the Qonto dashboard, OpenBao provision, and the read-only boundary. Note the
DUO complement (not replacement) and the OH-2026-003 tie-in (check API/plan
prerequisites while in the dashboard). Green lane.
```task
id: BINKY-WP-0005-T04
status: done
priority: medium
state_hub_task_id: "51364e7c-e842-4bcb-a0bb-6f4ceebe264b"
```
## Task: First read-only pull and CostRunRate update
After founder provisioning: promote the warden catalog to active, run the
first read-only balance/transaction pull through the harness lane, update
`finance/CostRunRate.md` TBC rows (desk rent, Qonto plan) with verified
figures, and log evidence metadata. Blue lane.
```task
id: BINKY-WP-0005-T05
status: wait
priority: medium
state_hub_task_id: "e4b2119b-6f89-44d8-879d-73bf225307f7"
```