sajn MCP server

The sajn MCP Server lets an AI assistant work in your live sajn workspaces — not just look at them. Find and read documents, draft them, fill them in, manage parties, send for signing, chase signatures, and follow status. It also carries the developer tools for debugging an integration: API request logs and outbound webhook deliveries. Install the sajn app in ChatGPT, or connect the server to Claude Desktop, Claude Code, Cursor, or any other MCP client. Then you run the everyday signing workflow from wherever you already work. It uses the same permission model as the REST API, so an assistant can never do more than you can.

This is not the same as the documentation MCP server at https://docs.sajn.se/mcp. That one only searches these docs and needs no login. The sajn MCP server connects to your real account data and requires authentication.

	Documentation MCP	sajn MCP
URL	`https://docs.sajn.se/mcp`	`https://app.sajn.se/api/mcp`
Auth	None (public)	OAuth 2.0
Data	Documentation only	Your live workspaces
Use for	”How do I…” questions	Working on real documents, debugging logs & webhooks

Server URL

https://app.sajn.se/api/mcp

The server is a stateless Streamable HTTP endpoint — every request carries its own bearer token, so any standard remote-MCP client works.

Authentication

The sajn MCP server uses OAuth 2.0. Most MCP clients, such as Claude, ChatGPT, and Cursor, find the server’s OAuth settings and start the sign-in themselves. The client opens the sajn consent screen, where you choose what the assistant gets:

Pick a workspace.
Pick a level for that workspace: Läs (read), Skriv (write), or Administrera (administer). Skriv is preselected.
To add another workspace from the same organization, select Lägg till arbetsyta and repeat the first two steps.
On the review step, use the ⋯ menu on a row to change its level, make it the default workspace with Gör till standard, or remove it.
Select Godkänn.

The first workspace you pick is the default unless you change it. There are no tokens to copy or rotate: the client refreshes them for you. The server works on every plan. A workspace created after you connect is not added to the connection. To include it, reconnect the server and pick it.

Levels and permissions

Each workspace in a connection has its own level:

Level	Scope	The assistant can
Läs	`sajn:read`	Read everything your role can read in the workspace
Skriv	`sajn:write`	Also create, change, and send, within your role
Administrera	`sajn:admin`	Also manage members, roles, and settings, within your role

A tool call passes four checks in the workspace it acts in, and each check can only narrow the one before it:

The level you granted for that workspace.
Your role in that workspace.
The workspace’s policy for AI agents in Inställningar > AI.
The workspace’s AI switch. A workspace with AI turned off refuses every tool call.

An assistant can therefore never do more than you can in that workspace. The tool list shows what your role and the agent policy allow. A call that needs a higher level than you granted returns an error that names the level it needs. Connections made before the levels existed hold per-resource scopes, such as documents:read, and keep working. Some tools need a workspace permission as well — most notably the developer tools, which require Manage developer (API logs) or Manage webhooks, so only developers can read raw traffic.

Working in several workspaces

A call acts in the default workspace unless it names another one. When a connection covers more than one workspace, every tool takes an optional workspaceId argument: the workspace’s id, slug, or name. The assistant fills it in, so you name the workspace in plain words, such as “create it in Juridik”.

getCurrentUser lists the connected workspaces and marks the default.
A call about an existing document runs in the workspace that holds the document, so you don’t name it.
Every result names the workspace the call acted in.
A workspace outside the connection is refused, and so is a name that two connected workspaces share. The error lists the connected workspaces.

A connection covers workspaces in one organization.

Tools

An MCP client loads every listed tool into every conversation, so the server lists only the 22 everyday tools. Every other tool is reached through findTools. The assistant does this itself: you ask in plain words, and it finds and runs the right tool. Each tool needs a level in the workspace it acts in, and most also need a permission in your role. Tools marked ^destructive send, delete, overwrite, or change access, so your client asks you before it runs them.

Everyday tools

Tool	Level	What it does
`createDocument`	Skriv	Creates a document, blank or from a template
`findDocuments`	Läs	Finds, lists and counts documents, including by what they say or by upcoming renewal
`summarizeContent`	Läs	Summarizes a document or template: purpose, parties, key terms, dates and clauses to watch
`getDocumentReadiness`	Läs	Checks whether a document is ready to send for signing
`getDocument`	Läs	Gets one document’s status, dates, parties, owner, source template and tags
`sendDocument`	Skriv	Sends a draft for signing to its parties ^destructive
`getSettings`	Läs	Gets a document’s or template’s settings, such as name, expiry date, invitation message, signing order and reminders
`getParties`	Läs	Gets the parties of a document or template, with contact details, role, signing method and order
`addParty`	Skriv	Adds a party to a document or template ^destructive
`getFields`	Läs	Gets the blocks of a document or template in order
`setFieldValues`	Skriv	Sets one or more values the sender fills in ^destructive
`findTemplates`	Läs	Finds the workspace’s templates, optionally filtered by name
`getTemplate`	Läs	Gets one template
`createContact`	Skriv	Creates a contact (a person) in the workspace address book
`findContacts`	Läs	Finds contacts by name (partial match), email or phone (exact match)
`addDocumentFile`	Skriv	Adds an uploaded PDF or Office file to a document
`reportMissingCapability`	Läs	Tells sajn about something the assistant needed but couldn’t do
`getCurrentUser`	Läs	Gets the connected user, the organization and the connected workspaces
`createUploadUrl`	Skriv	Creates a single-use URL to upload a file to
`findTools`	Läs	Searches the tools that are not listed and returns their input schemas
`runReadOnlyTool`	Läs	Runs a read-only tool that `findTools` returned
`runTool`	Level of the tool it runs	Runs a tool that changes data, which `findTools` returned

Reaching the other tools

findTools takes a description of the task, such as “invite a member”, and returns the best-matching tools with their input schemas.
The assistant runs a read-only match with runReadOnlyTool and any other match with runTool.

A call through runTool or runReadOnlyTool passes every check that a direct call passes, including the level of the tool it runs. If findTools returns a match under blockedByPolicy, the workspace’s AI agent policy has switched that tool off. An administrator can allow it under Inställningar > AI. The ChatGPT app works differently: it lists its tools directly and has no findTools. It covers the everyday signing workflow: createDocument, findDocuments, sendPartyReminder, summarizeContent, getDocumentReadiness, getDocument, sendDocument, withdrawDocument, getSettings, updateSettings, getSigningMethods, setCustomFieldValue, getParties, addParty, updateParty, removeParty, getFields, getField, addTextField, updateTextField, addFormField, updateFormField, removeField, getFieldValues, setFieldValues, getDocumentFile, findTemplates, getTemplate, createContact, updateContact, findContactsByCustomField, findContacts, getContact, createCompany, submitForApproval, findActions, dismissAction, snoozeAction, findCustomFields, getUsage, reportMissingCapability, getCurrentUser.

All tools by area

Documents

Tool	Level	What it does
`createDocument`	Skriv	Creates a document, blank or from a template
`findDocuments`	Läs	Finds, lists and counts documents, including by what they say or by upcoming renewal
`sendPartyReminder`	Skriv	Sends a manual reminder to one party who has not yet signed ^destructive
`summarizeContent`	Läs	Summarizes a document or template: purpose, parties, key terms, dates and clauses to watch
`getDocumentReadiness`	Läs	Checks whether a document is ready to send for signing
`startReview`	Skriv	Starts an AI legal review of a document or template
`getReviewStatus`	Läs	Gets the status of the latest AI review of a document or template
`getDocument`	Läs	Gets one document’s status, dates, parties, owner, source template and tags
`duplicateDocument`	Skriv	Copies a document, with its content and parties, into a new draft
`archiveDocument`	Skriv	Moves a document to the archive
`unarchiveDocument`	Skriv	Moves an archived document back to the active document list
`deleteDocument`	Skriv	Moves a document to the trash ^destructive
`restoreDocument`	Skriv	Restores a document from the trash
`setDocumentRetentionHold`	Skriv	Exempts a document from the retention policy, or removes the exemption ^destructive
`sendDocument`	Skriv	Sends a draft for signing to its parties ^destructive
`withdrawDocument`	Skriv	Withdraws a sent document so it becomes a draft again that can be edited and resent ^destructive
`completeDocument`	Skriv	Completes a sent document before every party has signed ^destructive
`addDocumentTag`	Skriv	Adds a tag to a document
`removeDocumentTag`	Skriv	Removes a tag from a document
`moveDocument`	Skriv	Moves a document into or out of a folder
`createDocumentShareLink`	Skriv	Returns a public view link for a document ^destructive
`deleteDocumentShareLink`	Skriv	Turns off a document’s public view link so the URL stops working
`getSettings`	Läs	Gets a document’s or template’s settings, such as name, expiry date, invitation message, signing order and reminders
`updateSettings`	Skriv	Changes a document’s or template’s settings, such as name, expiry date or reminders ^destructive
`getDocumentAuditLog`	Läs	Gets a document’s audit trail
`getVersionHistory`	Läs	Gets the version history of a document or template
`getLinkedDocuments`	Läs	Gets the documents linked to a document, such as amendments and renewals
`linkDocuments`	Skriv	Links two documents as an amendment, replacement, renewal or general relation
`deleteDocumentLink`	Skriv	Removes a link between two documents, such as an amendment or renewal relation, from both documents
`scheduleDocumentSend`	Skriv	Schedules a draft to be sent later ^destructive
`cancelScheduledSend`	Skriv	Cancels a scheduled send
`captureVersion`	Skriv	Saves the current document or template as a version in its history
`restoreVersion`	Skriv	Restores a document or template to an earlier version ^destructive
`getDocumentFile`	Läs	Gets a download link for the signed PDF, the signing certificate or the original
`addDocumentFile`	Skriv	Adds an uploaded PDF or Office file to a document

Content and fields

Tool	Level	What it does
`getFields`	Läs	Gets the blocks of a document or template in order
`getField`	Läs	Gets one block with its full content, including a form’s fields
`addTextField`	Skriv	Adds a text block for clauses and paragraphs
`updateTextField`	Skriv	Replaces the content of a text block ^destructive
`addFormField`	Skriv	Adds a form block of fields to fill in
`updateFormField`	Skriv	Changes a form block’s columns or fields ^destructive
`addTableField`	Skriv	Adds a data table without prices
`addProductTableField`	Skriv	Adds a price table with quantity, unit and VAT
`removeField`	Skriv	Removes a block with everything in it ^destructive
`moveField`	Skriv	Moves a block to another position
`setFieldVisibilityRule`	Skriv	Shows or hides a block depending on a yes/no or choice custom field
`replaceText`	Skriv	Replaces wording inside a text block ^destructive
`insertBlocks`	Skriv	Inserts paragraphs, headings, lists or tables into a text block
`deleteBlocks`	Skriv	Deletes paragraphs, list items, columns or tables inside a text block ^destructive
`moveFieldAfter`	Skriv	Moves a block to right after another block
`setFieldMeta`	Skriv	Sets a block’s settings, such as section style, visibility rule or lock ^destructive
`setVariable`	Skriv	Sets a variable in a text block that the sender fills in ^destructive
`getPdfFields`	Läs	Gets the fields placed on uploaded PDFs
`addPdfField`	Skriv	Adds a field on top of an uploaded PDF page
`updatePdfField`	Skriv	Moves, resizes or changes a field on an uploaded PDF
`removePdfField`	Skriv	Removes fields from uploaded PDFs, with their values ^destructive
`addSignatureFields`	Skriv	Adds a signature box per party where an uploaded PDF has signature lines
`getFieldValues`	Läs	Gets the values in form blocks and PDF fields, and who fills each one
`setFieldValues`	Skriv	Sets one or more values the sender fills in ^destructive

setFieldValues writes values in form blocks and in fields on uploaded PDFs, both the PDF’s own form fields and fields placed on top of it. getFieldValues lists each value with who fills it. A value assigned to a party is read-only: that party fills it in when signing.

Parties

Tool	Level	What it does
`getSigningMethods`	Läs	Lists the signing methods and identity checks this account can use
`getParties`	Läs	Gets the parties of a document or template, with contact details, role, signing method and order
`addParty`	Skriv	Adds a party to a document or template ^destructive
`updateParty`	Skriv	Changes a party on a document or template ^destructive
`removeParty`	Skriv	Removes a party from a document or template ^destructive

Signing methods and eID schemes are enabled market by market. Call getSigningMethods before setting a party’s signing method or identity check, rather than assuming a fixed list.

Approvals

Tool	Level	What it does
`findPendingApprovals`	Läs	Finds the documents waiting for your approval, with the approval chain
`submitForApproval`	Skriv	Submits a draft for approval before it is sent ^destructive
`approveDocument`	Skriv	Approves a document waiting for your approval ^destructive
`rejectDocument`	Skriv	Rejects a document waiting for your approval ^destructive
`getDocumentApproval`	Läs	Gets a document’s approval request and chain
`updateApprovalSteps`	Skriv	Changes the approvers of a document waiting for approval ^destructive
`cancelApproval`	Skriv	Cancels a pending approval so the document becomes a draft again
`sendApprovedDocument`	Skriv	Sends a fully approved document for signing ^destructive
`getTemplateApproval`	Läs	Gets the approval chain a template gives its documents
`setTemplateApproval`	Skriv	Sets the approval chain a template gives its documents

Comments

Tool	Level	What it does
`getComments`	Läs	Gets the comment threads on a document or template
`createComment`	Skriv	Starts a comment thread on a document or template
`replyToComment`	Skriv	Replies in a comment thread ^destructive
`updateComment`	Skriv	Changes a comment you wrote
`deleteComment`	Skriv	Deletes a comment you wrote ^destructive
`deleteCommentThread`	Skriv	Deletes a whole comment thread with all its messages ^destructive
`resolveCommentThread`	Skriv	Marks a comment thread as resolved, closing it while keeping its messages
`reopenCommentThread`	Skriv	Reopens a resolved comment thread
`setCommentVisibility`	Skriv	Shares a comment thread with the parties, or makes it internal again ^destructive
`acceptCommentSuggestion`	Skriv	Accepts a change suggestion from an AI review or a party
`rejectCommentSuggestion`	Skriv	Dismisses a change suggestion from an AI review or a party

Folders, tags and custom fields

Tool	Level	What it does
`findFolders`	Läs	Finds folders on one level of the folder tree
`createFolder`	Skriv	Creates a folder for documents or templates
`updateFolder`	Skriv	Renames a folder
`moveFolder`	Skriv	Moves a folder with everything in it
`deleteFolder`	Skriv	Deletes an empty folder ^destructive
`findTags`	Läs	Lists the workspace’s tags
`createTag`	Skriv	Creates a tag in the workspace
`updateTag`	Skriv	Renames or recolors a tag, or changes where it can be used
`deleteTag`	Skriv	Deletes a tag and removes it everywhere ^destructive
`getCustomFieldStatistics`	Läs	Shows how one custom field’s values are spread across signed documents
`setCustomFieldValue`	Skriv	Sets or clears a custom field’s value on a document, template or contact ^destructive
`findCustomFields`	Läs	Lists the workspace’s custom fields on documents and contacts
`createCustomField`	Skriv	Creates a custom field for documents or contacts
`updateCustomField`	Skriv	Changes a custom field
`deleteCustomField`	Skriv	Deletes a custom field with every value saved in it ^destructive

Actions, reminders and notifications

Tool	Level	What it does
`findActions`	Läs	Finds open cards in the Åtgärder feed, such as reminders, deadline extensions and renewals
`acceptAction`	Skriv	Accepts a card in the Åtgärder feed and runs it ^destructive
`dismissAction`	Skriv	Dismisses a card in the Åtgärder feed ^destructive
`snoozeAction`	Skriv	Postpones a card in the Åtgärder feed
`findNotifications`	Läs	Finds your in-app notifications
`markNotificationsRead`	Skriv	Marks notifications as read: the given ids from findNotifications, or every unread notification with `markAllRead`
`createReminder`	Skriv	Creates a personal reminder for a date
`createWatch`	Skriv	Creates a standing watch that adds cards to your Åtgärder feed
`findWatches`	Läs	Finds your active watches
`updateWatch`	Skriv	Changes a watch
`deleteWatch`	Skriv	Deletes a watch

Templates

Tool	Level	What it does
`findTemplates`	Läs	Finds the workspace’s templates, optionally filtered by name
`getTemplate`	Läs	Gets one template
`createTemplate`	Skriv	Creates a new, empty template
`duplicateTemplate`	Skriv	Duplicates a template
`deleteTemplate`	Skriv	Deletes a template permanently ^destructive
`setTemplateLock`	Skriv	Locks or unlocks a template
`setTemplateVisibility`	Skriv	Sets who in the workspace can see and use a template
`setTemplateSharing`	Skriv	Shares a template read-only with other workspaces, or stops sharing it ^destructive
`addTemplateTag`	Skriv	Adds a tag to a template
`removeTemplateTag`	Skriv	Removes a tag from a template
`moveTemplate`	Skriv	Moves a template into or out of a folder
`createTemplateFromDocument`	Skriv	Saves a document as a new template

Contacts, companies and products

Tool	Level	What it does
`createContact`	Skriv	Creates a contact (a person) in the workspace address book
`updateContact`	Skriv	Updates a contact’s name, email, phone or company ^destructive
`findContactsByCustomField`	Läs	Finds contacts by a custom field
`findContacts`	Läs	Finds contacts by name (partial match), email or phone (exact match)
`getContact`	Läs	Gets one contact
`deleteContact`	Skriv	Deletes a contact from the address book ^destructive
`findCompanies`	Läs	Finds companies in the address book
`getCompany`	Läs	Gets one company from the address book
`createCompany`	Skriv	Creates a company in the address book
`getContactNotes`	Läs	Gets the internal notes on a contact
`createContactNote`	Skriv	Adds an internal note to a contact
`deleteContactNote`	Skriv	Deletes a note from a contact ^destructive
`getContactTags`	Läs	Gets the tags on one contact
`addContactTag`	Skriv	Adds a tag to a contact
`removeContactTag`	Skriv	Removes a tag from a contact
`deleteCompany`	Skriv	Deletes a company from the address book ^destructive
`updateCompany`	Skriv	Updates a company in the address book
`findUnlinkedDocumentParties`	Läs	Finds document parties who aren’t in the address book yet
`createContactsFromParties`	Skriv	Creates contacts from document parties and links them
`findProducts`	Läs	Finds products in the product library
`createProduct`	Skriv	Creates a product in the workspace product library
`updateProduct`	Skriv	Updates a product in the product library
`deleteProduct`	Skriv	Deletes a product from the product library ^destructive

sajn ID

Tool	Level	What it does
`createIdentityCheck`	Skriv	Creates a sajn ID identity check and sends its link by email or SMS ^destructive
`findIdentityChecks`	Läs	Finds sajn ID identity checks
`getIdentityCheck`	Läs	Gets one sajn ID identity check

Reports

Tool	Level	What it does
`getDocumentStatistics`	Läs	Gets document statistics for a period
`createReport`	Skriv	Creates a saved report
`updateReport`	Skriv	Replaces a saved report’s content
`findReports`	Läs	Lists the saved reports

Members and roles

Tool	Level	What it does
`findMembers`	Läs	Lists the members of the workspace or the organization
`getMember`	Läs	Gets one organization member, with their workspaces and roles
`addWorkspaceMember`	Administrera	Adds a member to the workspace, or invites a new person by email ^destructive
`setMemberRole`	Administrera	Changes a member’s role in the organization or the workspace ^destructive
`suspendMember`	Administrera	Suspends a member so they can no longer sign in ^destructive
`resumeMember`	Administrera	Resumes a suspended member
`removeMember`	Administrera	Removes a member from the organization or the workspace ^destructive
`findInvites`	Läs	Lists the open invites
`inviteMembers`	Administrera	Invites people by email to the organization and its workspaces ^destructive
`resendInvite`	Administrera	Sends a pending invite again ^destructive
`revokeInvite`	Administrera	Withdraws a pending invite ^destructive
`findPermissions`	Läs	Lists the workspace and organization permissions and what each one means
`findRoles`	Läs	Lists the roles with their permissions and member count
`createRole`	Administrera	Creates a role with a set of permissions ^destructive
`updateRole`	Administrera	Renames a role or changes its permissions ^destructive
`deleteRole`	Administrera	Deletes a role ^destructive
`findRoleBlueprints`	Läs	Lists the role blueprints: workspace roles defined once for the organization
`createRoleBlueprint`	Administrera	Creates a role blueprint ^destructive
`updateRoleBlueprint`	Administrera	Renames a role blueprint or changes its permissions ^destructive
`deleteRoleBlueprint`	Administrera	Deletes a role blueprint ^destructive
`applyRoleBlueprint`	Administrera	Creates a blueprint as a linked role in one workspace or in all of them
`removeRoleFromBlueprint`	Administrera	Unlinks a workspace role from its blueprint

Workspace and organization settings

Tool	Level	What it does
`getWorkspaceSettings`	Läs	Gets every setting of the workspace
`updateWorkspaceAiSettings`	Administrera	Changes the workspace’s AI settings ^destructive
`updateWorkspaceDocumentSettings`	Administrera	Changes the workspace’s defaults and policies for new documents ^destructive
`updateWorkspaceRetentionSettings`	Administrera	Changes how long the workspace keeps documents ^destructive
`updateWorkspaceSearchSettings`	Administrera	Changes the workspace’s search settings
`findMessageTemplates`	Läs	Lists the workspace’s saved invitation messages
`createMessageTemplate`	Administrera	Creates a saved invitation message
`updateMessageTemplate`	Administrera	Changes a saved invitation message
`deleteMessageTemplate`	Administrera	Deletes a saved invitation message ^destructive
`findDocumentCategories`	Läs	Lists the workspace’s document types
`createDocumentCategory`	Administrera	Creates a document type
`updateDocumentCategory`	Administrera	Renames a document type or changes its custom fields
`deleteDocumentCategory`	Administrera	Deletes a document type ^destructive
`findEmailTemplates`	Läs	Lists the emails sajn sends whose text the workspace can customize
`getEmailTemplate`	Läs	Gets one email’s text in one language
`updateEmailTemplate`	Administrera	Customizes one email’s text in one language
`restoreDefaultEmailTemplate`	Administrera	Restores one email’s default text in one language ^destructive
`findPlaybookRules`	Läs	Lists the playbook rules that steer how AI reads and reviews documents
`createPlaybookRule`	Administrera	Adds a rule to the playbook
`updatePlaybookRule`	Administrera	Rewrites a playbook rule
`deletePlaybookRule`	Administrera	Deletes a playbook rule ^destructive
`getOrganization`	Läs	Gets the organization’s details and organization-wide settings
`updateOrganization`	Administrera	Changes the organization’s business details
`updateDelegationSettings`	Administrera	Changes whether signing parties may delegate their signing
`updateUsageAlertSettings`	Administrera	Changes when members are alerted about usage
`getSecuritySettings`	Läs	Gets the organization’s two-factor and sign-in country rules
`findWorkspaces`	Läs	Lists the workspaces you are a member of
`createWorkspace`	Administrera	Creates a workspace
`updateWorkspace`	Administrera	Renames a workspace or changes its color or icon
`findAuditLogEvents`	Läs	Searches the organization’s audit log
`getInboxSettings`	Läs	Gets the workspace’s inbox addresses and allowed senders
`updateInboxSettings`	Administrera	Sets which senders may create documents by email
`getUsage`	Läs	Gets the organization’s usage in the current billing period

Your account

Tool	Level	What it does
`getMyProfile`	Läs	Gets your profile
`updateMyProfile`	Skriv	Changes your name or phone number
`getMyNotificationSettings`	Läs	Gets your notification settings
`updateMyNotificationSettings`	Skriv	Changes your notification settings

Developer tools

Tool	Level	What it does
`findApiLogs`	Läs	Finds v1 REST API request logs
`getApiLog`	Läs	Gets one REST API request log
`findWebhooks`	Läs	Finds the webhook endpoints
`getWebhook`	Läs	Gets one webhook endpoint
`createWebhook`	Skriv	Creates a webhook endpoint ^destructive
`updateWebhook`	Skriv	Changes a webhook endpoint ^destructive
`deleteWebhook`	Skriv	Deletes a webhook endpoint ^destructive
`findWebhookDeliveries`	Läs	Finds outbound webhook deliveries
`getWebhookDelivery`	Läs	Gets one webhook delivery with its request and response

Connection and support

Tool	Level	What it does
`getCurrentUser`	Läs	Gets the connected user, the organization and the connected workspaces
`createUploadUrl`	Skriv	Creates a single-use URL to upload a file to
`findTools`	Läs	Searches the tools that are not listed and returns their input schemas
`runReadOnlyTool`	Läs	Runs a read-only tool that `findTools` returned
`runTool`	Level of the tool it runs	Runs a tool that changes data, which `findTools` returned
`createSupportTicket`	Skriv	Sends a support ticket to the sajn team, with the conversation attached ^destructive
`reportMissingCapability`	Läs	Tells sajn about something the assistant needed but couldn’t do

Uploading a PDF

A tool call carries JSON, not file bytes, so the file itself never goes through the MCP connection. How it reaches sajn depends on whether the assistant can run shell commands or raw HTTP requests. Assistants that can run commands (Claude Code, agents with a shell tool) upload on their own:

createDocument creates the draft.
createUploadUrl returns a single-use upload URL and an uploadKey.
The assistant sends the file to that URL in a PUT request.
addDocumentFile adds the file to the document. Word, Excel, and other Office files are converted to PDF at this step.

Other assistants hand the upload back to you:

The assistant calls createDocument and gives you the link it returns.
You open the link and drag the PDF onto the document.
You tell the assistant it’s uploaded, and it continues — getFields to see the PDF, getFieldValues to see what can be filled in, then parties and sending as usual.

The link is an ordinary document URL, not a token — opening it requires your own sajn login. An assistant that asks you to paste a document’s contents into the chat is getting it wrong.

Files can be PDF, Word, Excel, PowerPoint, CSV, or plain text, up to 25 MB.

Importing signed agreements into the archive

To add agreements that were signed outside sajn, ask the assistant to import them into the archive. It creates one document per file with type set to ARCHIVE_IMPORTED, titled after the file name, and attaches the file through either of the preceding routes.

Setup

ChatGPT
Claude Code
Claude Desktop
Cursor
VS Code

Open the sajn app in the ChatGPT app directory.
Connect the app.
Sign in to sajn, pick the workspaces and a level for each, and select Godkänn.

The ChatGPT app covers the everyday signing workflow: drafting, filling in, parties, sending, and follow-up. It has no developer tools, and it doesn’t accept personal identity numbers. Add those to the party in sajn.

claude mcp add --transport http sajn https://app.sajn.se/api/mcp

On first use Claude Code opens the sajn OAuth consent screen in your browser. Pick the workspaces and a level for each, and select Godkänn. Verify with:

claude mcp list

Open Settings > Connectors > Add Connector
Enter:
- Name: sajn
- URL: https://app.sajn.se/api/mcp
Click Save, then complete the OAuth consent flow when prompted.

Open Cursor Settings: Open MCP Config and add:

{
  "mcpServers": {
    "sajn": {
      "url": "https://app.sajn.se/api/mcp"
    }
  }
}

Restart Cursor and complete the OAuth flow.

Create .vscode/mcp.json:

{
  "servers": {
    "sajn": {
      "type": "http",
      "url": "https://app.sajn.se/api/mcp"
    }
  }
}

Example prompts

Working on documents

“Draft an NDA from our standard template, add Anna at Ribban as signer with BankID, and show it to me before sending.”
“What’s still missing on the Volvo agreement before I can send it?”
“Fill in the amount as 45 000 SEK and the start date as 1 September, then send it.”
“Add a price table with 10 hours of consulting at 1 200 SEK, 25% VAT.”

Following up

“Which documents are waiting for signatures, and who’s holding them up?”
“Remind everyone who hasn’t signed the Q3 contracts.”
“What expires in the next 30 days?”
“Push the deadline on the Ribban agreement out by two weeks.”

Debugging an integration

“List the failed webhook deliveries from the last day and show me the response body of the first one.”
“Find the API requests that returned 4xx today and tell me what’s wrong with them.”
“Which webhook endpoint is failing, and what status code is it returning?”

Security

Workspace-scoped — a connection only reaches the workspaces you picked at consent, all in one organization.
Least privilege — each call is checked against the level you granted for the workspace it acts in, and developer tools also need a workspace permission.
Same enforcement as REST — scopes and role permissions are re-checked on every tool call, not just at listing time.
Confirmation hints — tools that email or SMS a counterparty, or destroy work, are marked destructive so your client can prompt first.
Rate limited — per-IP and per-organization limits apply, the same as the REST API.

Troubleshooting

Tool names changed — my scripts broke

The tools now share their names with the assistant built into sajn. The most common renames:

Old name	Current tool
`whoami`	`getCurrentUser`
`listDocuments`, `findDocumentsByDate`, `findDocumentsByExpiration`, `findDocumentsByCustomField`, `findDocumentsByParty`, `searchDocumentContent`, `getPendingSignatures`	`findDocuments`, with its filters
`getDocumentDetails`	`getDocument`
`getDocumentParties`, `getDocumentSigners`	`getParties`
`addSignerToDocument`, `updateSignerOnDocument`, `removeSignerFromDocument`	`addParty`, `updateParty`, `removeParty`
`getDocumentSettings`, `updateDocumentSettings`	`getSettings`, `updateSettings`
`renameDocument`, `setDocumentExpiration`, `extendDocumentExpiration`	`updateSettings`
`listFields`	`getFields`
`listFillableFields`, `fillFields`	`getFieldValues`, `setFieldValues`
`checkDocumentReadiness`	`getDocumentReadiness`
`addTable`, `addProductTable`	`addTableField`, `addProductTableField`
`attachFileToDocument`	`addDocumentFile`
`listSigningMethods`	`getSigningMethods`
`sendDocumentReminder`	`sendPartyReminder`
`getPendingApprovals`	`findPendingApprovals`
`getTemplateDetails`	`getTemplate`
`findContact`, `getContactDetails`, `getCompanyDetails`	`findContacts`, `getContact`, `getCompany`
`moveDocumentToFolder`, `addTagToDocument`	`moveDocument`, `addDocumentTag`
`getDocumentShareLink`	`createDocumentShareLink`
`list_api_logs`, `get_api_log`	`findApiLogs`, `getApiLog`
`list_webhook_deliveries`, `get_webhook_delivery`	`findWebhookDeliveries`, `getWebhookDelivery`
`list_webhooks`, `get_webhook`, `create_webhook`, `update_webhook`, `delete_webhook`	`findWebhooks`, `getWebhook`, `createWebhook`, `updateWebhook`, `deleteWebhook`
`list_sajn_ids`, `get_sajn_id`	`findIdentityChecks`, `getIdentityCheck`

For anything else, call findTools with what you want to do.

The debugging tools don't show up

The member must hold the matching workspace permission — Manage developer for API logs, Manage webhooks for deliveries. A connection made before the levels existed also needs the audit:read scope. To get it, reconnect the server.

Connection rejected / 401

Confirm the URL is https://app.sajn.se/api/mcp (note /api/mcp, not /mcp).
Reconnect the server and complete the OAuth consent flow again.

The assistant says the application lacks permission

The call needs a higher level than you granted for that workspace, such as Skriv to create or send. Reconnect the server and pick a higher level for the workspace.

The assistant works in the wrong workspace

Name the workspace in your request, such as “in Juridik”. To change which workspace it uses by default, reconnect the server and use Gör till standard on the review step. A workspace created after you connected is not in the connection until you reconnect.

The assistant says it can't edit a sent document

That’s correct — parties, fields and content are locked once a document is out for signing. Withdraw it with withdrawDocument to make it a draft again (the parties are notified), or move the expiry date with updateSettings if that’s all you need.

Next steps

Choosing an authentication method

The OAuth flow above is for assistant clients — see which credential your own integration needs

Webhooks

Set up and debug webhook endpoints