Reconnect and Troubleshoot
Update your connection when the Spiris tools have changed, or when the connection stops working. The address is always https://mcp.spiris.se/mcp. Connecting Spiris MCP for the first time? See Getting started.
You see the current tool names in your AI service's list of tools.
Claude
- Start a new chat. Claude usually fetches the tools again by itself and asks you to approve them.
- If you still see old tools, or the tools are missing: Settings â Connectors â Spiris â Disconnect, then Connect again.
- Team and Enterprise: the Owner does not need to change the connector. If you have turned off individual tools for the organization, redo those choices.
- Projects: if your project instructions name tools, update them to the current names.
ChatGPT
ChatGPT does not fetch changed tools by itself. You need to press Refresh.
- Plus and Pro: Settings â Apps & Connectors â Spiris â Refresh. Turn on any tools that show as off.
- Business and Enterprise: an admin presses Refresh and republishes the connector to the workspace.
- Custom GPTs and projects: update any tool names in the instructions.
- If Refresh does not help: remove the connector and add it again with
https://mcp.spiris.se/mcp. You will need to log in again.
Microsoft Copilot Studio
- When the tools have changed: open the agent â Tools, redo the tool choices for Spiris, update topics that mention tool names, and publish the agent again.
- Use OAuth 2.0 with Dynamic discovery for the login, not manual OAuth settings.
- If the login does not work, or the agent was set up with manual OAuth: remove the Spiris tool and add it again as a Model Context Protocol tool, with
https://mcp.spiris.se/mcpand Dynamic discovery.
Other AI services and your own code
This covers, for example, VS Code, Cursor and Claude Code.
- Restart the Spiris server or refresh the connector. In VS Code: run MCP: List Servers, choose spiris and choose Restart.
- Log in with your Visma account when asked. If Visma asks you to approve access for the service, approve it.
- Update the tool names wherever you picked tools by hand, for example in lists of allowed tools and in automations.
In Claude Code you reconnect with /mcp. If the login gets stuck, choose spiris in /mcp, clear the login and log in again. If you named the server spiris as in Getting started, the rule mcp__spiris allows all Spiris tools.
If you connect through mcp-remote: delete the ~/.mcp-auth folder and restart.
Your own code: read the tools from tools/list instead of hard-coding names. Login requires dynamic client registration and PKCE with S256, and the login server is found through /.well-known/oauth-protected-resource. Clients that run entirely in a web browser do not work yet.
If something does not work
| What happens | What to do |
|---|---|
| "unknown tool", or the tools are missing | Refresh the connector (ChatGPT: Refresh), or disconnect and connect again. |
| You are asked for permission on every call | Approve the tools again, or update the names in your permission rules. |
| The login gets stuck | Disconnect Spiris and connect again. |
| The connection fails right after you log in (some services show 403 or Forbidden) | MCP â Beta is probably not activated for you in the company you logged in to. See Activate the service. If you have several companies: disconnect, connect again and choose another company. |
| The AI asks which company to use | That is expected if you work for several companies. Say which company you mean. |
Spiris MCP: koppla om och felsök
Uppdatera kopplingen nÀr Spiris-verktygen har Àndrats, eller nÀr kopplingen slutar fungera. Adressen Àr alltid https://mcp.spiris.se/mcp. Ska du koppla Spiris MCP för första gÄngen? Se SÄ kommer du igÄng.
De nuvarande verktygsnamnen ser du i AI-tjÀnstens lista över verktyg.
Claude
- Starta en ny chatt. Claude hÀmtar oftast verktygen igen av sig sjÀlv och ber dig godkÀnna dem.
- Syns gamla verktyg fortfarande, eller saknas verktygen: Settings â Connectors â Spiris â Disconnect, och sedan Connect igen.
- Team och Enterprise: Owner behöver inte Àndra connectorn. Har ni stÀngt av enskilda verktyg för organisationen, gör om de valen.
- Projects: nÀmner projektinstruktionerna verktyg med namn, byt till de nuvarande namnen.
ChatGPT
ChatGPT hÀmtar inte Àndrade verktyg sjÀlv. Du behöver trycka Refresh.
- Plus och Pro: Settings â Apps & Connectors â Spiris â Refresh. SlĂ„ pĂ„ verktyg som visas som avstĂ€ngda.
- Business och Enterprise: admin trycker Refresh och publicerar om connectorn till workspacet.
- Custom GPTs och projekt: byt verktygsnamn i instruktionerna.
- HjÀlper inte Refresh: ta bort connectorn och lÀgg till den igen med
https://mcp.spiris.se/mcp. DÄ behöver du logga in pÄ nytt.
Microsoft Copilot Studio
- NĂ€r verktygen har Ă€ndrats: öppna agenten â Tools, gör om verktygsvalen för Spiris, uppdatera topics som nĂ€mner verktyg med namn och publicera agenten igen.
- AnvÀnd OAuth 2.0 med Dynamic discovery för inloggningen, inte manuella OAuth-instÀllningar.
- Fungerar inte inloggningen, eller Àr agenten instÀlld med manuell OAuth: ta bort Spiris-verktyget och lÀgg till det igen som ett Model Context Protocol-verktyg, med
https://mcp.spiris.se/mcpoch Dynamic discovery.
Ăvriga AI-tjĂ€nster och egen kod
GĂ€ller till exempel VS Code, Cursor och Claude Code.
- Starta om Spiris-servern eller uppdatera connectorn. I VS Code: kör MCP: List Servers, vÀlj spiris och vÀlj Restart.
- Logga in med ditt Visma-konto nÀr du ombeds. Ber Visma dig godkÀnna Ätkomst för tjÀnsten, godkÀnner du det.
- Byt verktygsnamn dÀr du har valt verktyg för hand, till exempel i listor över tillÄtna verktyg och i automationer.
I Claude Code kopplar du om med /mcp. Fastnar inloggningen: vÀlj spiris i /mcp, rensa inloggningen och logga in igen. Har du döpt servern till spiris som i SÄ kommer du igÄng, tillÄter regeln mcp__spiris alla Spiris-verktyg.
Kopplar du via mcp-remote: ta bort mappen ~/.mcp-auth och starta om.
Egen kod: lÀs verktygen frÄn tools/list i stÀllet för att skriva in namnen i koden. Inloggningen krÀver dynamisk klientregistrering och PKCE med S256, och inloggningsservern hittas via /.well-known/oauth-protected-resource. Klienter som körs helt i webblÀsaren fungerar inte Àn.
Om nÄgot inte fungerar
| Det hÀr hÀnder | Gör sÄ hÀr |
|---|---|
| "unknown tool", eller verktygen saknas | Uppdatera connectorn (ChatGPT: Refresh), eller koppla frÄn och anslut igen. |
| Du fÄr frÄgan om lov vid varje anrop | GodkÀnn verktygen igen, eller byt namnen i dina behörighetsregler. |
| Inloggningen fastnar | Koppla frÄn Spiris och anslut igen. |
| Kopplingen misslyckas direkt efter inloggningen (vissa tjĂ€nster visar 403 eller Forbidden) | MCP â Beta Ă€r troligen inte aktiverat för dig i företaget du loggade in i. Se Aktivera tjĂ€nsten. Har du flera företag: koppla frĂ„n, anslut igen och vĂ€lj ett annat företag. |
| AI:n frÄgar vilket företag den ska anvÀnda | Det Àr vÀntat om du arbetar i flera företag. Skriv vilket företag du menar. |
Updated about 12 hours ago
