Skip to docs content

Product guide

How AI apps work with 42six

What an MCP connector is, how the 42six one works from sign-in to a confirmed change, how to turn it off, and which questions and jobs each tool answers.

What a connector is

The Model Context Protocol (MCP) is the standard way an AI app, such as Claude or ChatGPT, uses tools that live somewhere else. A plugin that gives an AI app tools this way is called a connector, a custom connector or an MCP server, depending on the app. 42six runs one. Once it is connected, the AI app can look at your books to answer a question and, with your approval, change them.

How the 42six connector works

  • Add https://42six.ai/mcp to the AI app as a remote MCP server. There is no key to paste.
  • The app sends you to 42six to sign in and approve it. The page is titled Allow the app to use your books?
  • Choose which of your books it can reach. You can choose more than one, across workspaces you belong to.
  • It may read your books: the ledger, bank activity and reports. When the app asked to make changes, the page also says it may make changes to these books, and Allow approves both.
  • Allow sends you back to the app. The app now has tools for the books you chose.
  • Settings › Connected apps lists the app, its access (Reads, or Reads and proposes changes) and its books. Disconnect ends everything the app holds; its next request is refused.

Behind the switch, the app holds two permissions: books:read, and books:write only when you allowed changes.

Reads and changes

  • The app can always read the books you chose: fourteen read tools, with list_books to find the books.
  • An app that asked to make changes also gets six change tools. Every change is previewed first.
  • A preview changes nothing. It answers with a plan_id, an expiry and a summary: the book, the accounts, the transactions or lines it touches (a long plan lists the first ones and says how many more it includes), the debit and credit totals, and what it left out and why.
  • The app shows you the summary. Only when you say yes does it call apply_change with that plan_id.
  • The plan is good for 10 minutes. After that, or if the books changed meanwhile, nothing is applied and the app previews again.
  • apply_change is all or nothing, and applying the same plan again returns its first result without changing the books twice.

The Changes: preview and apply page has every refusal and the limits.

Apps that are documented

Connect your AI app has the steps for Claude on Claude.ai and Claude Desktop, ChatGPT, Grok Bot, Claude Code, Cursor and VS Code. Any MCP client that supports remote servers with sign-in works with the same address. An app without sign-in can use an API key instead, which reads only.

What you can ask

Each job, with the tools an app uses to do it. Reads need no confirmation. A change always ends with you confirming a preview.

  • Which books do I have? list_books (list_entities for an API key).
  • What is the chart of accounts? list_accounts.
  • Which transactions are not posted yet? needs_review. Categorize and post them: preview_categorize, then apply_change.
  • Show the bank activity for a month. list_bank_transactions with from and to.
  • What did I spend on software in September? income_statement for the month, or list_journal_lines for one account and the dates.
  • Am I making money this year? analytics with the ytd window, or income_statement.
  • How are revenue, expenses and profit trending month by month? monthly_income_trend. What came in and went out of the bank? list_bank_transactions with from and to. What is my cash today? balance_sheet, or analytics.
  • Do the books balance? balance_sheet reports whether it balances; trial_balance shows each account.
  • What rules do I have? list_rules. Add one: preview_rule, then apply_change.
  • That posted to the wrong account. list_journal_lines to find the lines, preview_move, then apply_change.
  • Post an adjusting entry. list_accounts, then preview_journal_entry and apply_change.
  • Undo a manual entry. list_journal_entries to find it, preview_reverse, then apply_change.
  • Is a month reconciled? reconciliation_status. Is it locked? period_locks.
  • What do my companies look like together? list_consolidation_groups, then consolidated_statements for a saved group.

Tips for an agent

  • Start with list_books. Most tools take one of its ids as entity; apply_change takes only the plan_id.
  • Page through long answers with the cursor and next_cursor; a page shorter than the limit is the last.
  • Money is a decimal string. In bank transactions a positive amount is money out; in journal lines a debit is positive.
  • In a preview, name an account by id, role key, code or exact name; a name that matches more than one account is refused with the choices. Read tools such as list_journal_lines take the account id from list_accounts.
  • Show the user the whole preview summary before calling apply_change, and call it only after the user says yes.
  • Do not retry a refused change blindly: read the reason, then preview again if the books changed.

What an app cannot do

An app never locks or closes a period, closes a year, deletes anything, connects a bank, or touches billing, sign-in, members or invitations. It cannot read documents or trackers.