sajn MCP server
Connect an AI assistant to your sajn workspaces over the Model Context Protocol — draft documents, fill them in, manage parties, send for signing, chase signatures, and debug your integration
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://www.sajn.se/docs/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://www.sajn.se/docs/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/mcpThe 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".
getCurrentUserlists 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
findToolstakes 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
runReadOnlyTooland any other match withrunTool.
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:
createDocumentcreates the draft.createUploadUrlreturns a single-use upload URL and anuploadKey.- The assistant sends the file to that URL in a
PUTrequest. addDocumentFileadds 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
createDocumentand 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 —
getFieldsto see the PDF,getFieldValuesto 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
- 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.
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
Was this page helpful?
Last updated on