Reconnect and Troubleshoot


🇾đŸ‡Ș LĂ€s pĂ„ svenska

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/mcp and Dynamic discovery.

Other AI services and your own code

This covers, for example, VS Code, Cursor and Claude Code.

  1. Restart the Spiris server or refresh the connector. In VS Code: run MCP: List Servers, choose spiris and choose Restart.
  2. Log in with your Visma account when asked. If Visma asks you to approve access for the service, approve it.
  3. 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 happensWhat to do
"unknown tool", or the tools are missingRefresh the connector (ChatGPT: Refresh), or disconnect and connect again.
You are asked for permission on every callApprove the tools again, or update the names in your permission rules.
The login gets stuckDisconnect 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 useThat 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/mcp och Dynamic discovery.

Övriga AI-tjĂ€nster och egen kod

GĂ€ller till exempel VS Code, Cursor och Claude Code.

  1. Starta om Spiris-servern eller uppdatera connectorn. I VS Code: kör MCP: List Servers, vÀlj spiris och vÀlj Restart.
  2. Logga in med ditt Visma-konto nÀr du ombeds. Ber Visma dig godkÀnna Ätkomst för tjÀnsten, godkÀnner du det.
  3. 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ÀnderGör sÄ hÀr
"unknown tool", eller verktygen saknasUppdatera connectorn (ChatGPT: Refresh), eller koppla frÄn och anslut igen.
Du fÄr frÄgan om lov vid varje anropGodkÀnn verktygen igen, eller byt namnen i dina behörighetsregler.
Inloggningen fastnarKoppla 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ÀndaDet Àr vÀntat om du arbetar i flera företag. Skriv vilket företag du menar.

Did this page help you?