Claude connector

The Sway connector for Claude lets Claude Desktop read your Sway workspaces through the Sway API. Ask which invoices are overdue or which bank transactions are not reconciled yet, and Claude looks them up. When you allow it, Claude can also make changes, such as confirming the match between an invoice and a bank transaction, within the scopes of your key.

Before you start

• Claude Desktop on macOS or Windows. Claude on the web and the mobile apps cannot use the connector.
• A licence that includes the Sway API. The base licence covers the whole platform; a higher tier adds the public API. Contact Sway to add it.
• Nothing else to install: Claude Desktop runs the connector itself.

Set it up

1. Create an API key. In Sway, choose your name at the bottom of the sidebar, then Profile, Developer and Create API key. Name the key after Claude, tick Read for each resource that Claude may see, such as invoices, bank-accounts and counterparties, and choose when it expires. Copy the secret key, which Sway shows once: Developer and API keys explains each field.
2. Download the connector. Choose Download for Claude Desktop above. The file ends in .mcpb.
3. Install it. Open the file: Claude Desktop shows the install dialog of Sway Workspace (Beta). It warns that the publisher is unverified, since the beta is not signed yet; choose Install.
4. Paste the key. Paste the secret key into Sway API key. Leave Allow writes off, and Sway API base URL as it is. Claude Desktop keeps the key in the keychain of your computer, not in a file.
5. Test the connection. Start a new chat and write “Test my Sway connection.” Claude lists the workspaces that your key reaches.

Then ask, for example:

• “Which invoices in workspace name are still unpaid and overdue?”
• “Show me the unreconciled bank transactions of last month in workspace name.”

What Claude can do

The connector gives Claude four tools, which Claude Desktop names when it asks for your approval:

• sway_test_connection shows your user, the key and the workspaces that it reaches.
• sway_api_spec reads the documentation of the Sway API, so the connector follows each new version of the API without an update.
• sway_read calls an endpoint that reads data.
• sway_write calls an endpoint that creates, changes or deletes data. Claude gets it only when Allow writes is on.

Let Claude make changes

Claude changes data only when both of these are true:

• Allow writes is on, in the settings of Sway Workspace (Beta) in Claude Desktop.
• The key has the Write box of the resource, such as invoices to confirm a match.

Claude Desktop asks you before each change. Answer Allow once for sway_write: Always allow stops it asking before every later change. Check in Sway what Claude changed.

Your key and your data

• Claude Desktop keeps the key in the keychain of your computer. The connector sends it only to the Sway API, over HTTPS, and accepts no other address.
• The connector sends no usage data, and contacts no server but the Sway API.
• What the Sway API answers goes into your chat with Claude, as a file that you share with Claude does.
• The connector never repeats a change: after a timeout, Claude reads the data back before it tries again.

Remove access

• Revoke the key in Sway, under Profile › Developer: the connector stops at once.
• Or uninstall Sway Workspace (Beta) in the settings of Claude Desktop, under Extensions.

If something goes wrong

Claude shows	What to do
No API key configured	Open the settings of Claude Desktop, then Extensions and Sway Workspace (Beta), and paste the key again.
HTTP 401	The key is wrong, expired or revoked: create a new one.
HTTP 403	The key lacks the scope of what you asked: create a key with that scope, or ask within the current one.
HTTP 409	The workspace is suspended, since its subscription has ended.
HTTP 429	Too many requests in a minute: wait a minute, then ask again.

For anything else, contact Sway with the sentence that Claude showed you.