Anslut din agent

Asamla har en MCP-server. Koppla Claude, ChatGPT, Claude Code eller en annan agent till den, så kan agenten läsa din organisations bokföring, uppgifter, bokningar och kalender och förbereda arbete åt dig. Det som ändrar något med verkan godkänner du själv.

Du behöver ett Asamla-konto och ett medlemskap i den organisation agenten ska arbeta i. Agenten får ingen egen inloggning; den arbetar som dig. Skapa konto om du inte har ett.

Adressen

https://www.asamla.se/api/mcp

Servern talar MCP över HTTP (Streamable HTTP) och kräver inloggning. Utan en inloggad agent svarar den med en utmaning som pekar ut var agenten ska logga in. Det är samma adress för alla organisationer; vilken organisation agenten arbetar i väljer den under samtalet.

Så loggar agenten in

Inloggningen är OAuth med PKCE, och du behöver inte skapa någon nyckel eller token själv.

1. Agenten hämtar /.well-known/oauth-protected-resource och /.well-known/oauth-authorization-server och ser därur var inloggningen sker.
2. Den registrerar sig själv hos Asamla (dynamisk klientregistrering, /api/auth/oauth2/register). Det finns inget klient-id att be om i förväg.
3. Ett webbläsarfönster öppnas där du loggar in med ditt vanliga Asamla-konto, en gång. Därefter förnyar agenten sin åtkomst själv.

Omfattningarna (scopes) som servern erbjuder är openid, profile, email och offline_access. De räcker för att veta vem du är och för att hålla inloggningen vid liv; åtkomsten till själva uppgifterna begränsas inte av en omfattning utan av din roll. Agenten ser exakt det du själv får se, i de organisationer du är med i, och kan inte mer än du kan.

Du ser och kopplar från anslutna agenter under din profil i Asamla (kortet AI-assistenter). Kopplar du från en agent slutar dess åtkomst att fungera.

Anslut

Claude Code

claude mcp add --transport http asamla https://www.asamla.se/api/mcp

Skriv sedan /mcp i Claude Code, välj asamla och logga in.

Claude, ChatGPT, Cursor och andra appar

Lägg till en anslutning (en "anslutningsapp", "connector" eller "custom MCP server", beroende på appen), klistra in adressen ovan och logga in när du blir ombedd. Var det ligger i menyerna skiljer sig mellan apparna.

Annan klient

Alla klienter som kan prata med en fjärransluten MCP-server över HTTP med OAuth fungerar. Många läser en konfiguration i den här formen:

{
  "mcpServers": {
    "asamla": {
      "type": "http",
      "url": "https://www.asamla.se/api/mcp"
    }
  }
}

Kan klienten bara starta lokala (stdio) servrar får du en brygga som gör den fjärranslutna servern lokal:

npx mcp-remote https://www.asamla.se/api/mcp

Vad agenten kan göra

Först väljer agenten organisation. Har du flera frågar den vilken, och väljer med set_organization. Sedan gäller det här.

Läsa

Agenten kan läsa det du själv kan läsa: bokföringsläget och verifikationerna, banktransaktioner, resultat- och balansräkning, kontoplan, Inkorgen med inlästa kvitton och fakturor, momsperioder, kundfakturor och kunder, inkomna betalningar, budget, lönekörningar och lönebesked, uppgifter, projekt, bokningar, evenemang, kalender, medlemmar och dokument. Läsningarna kräver ingen bekräftelse; klienten får veta att de bara läser.

Förbereda och lägga in

Agenten kan göra utkast som inget ännu hänger på: ett verifikationsutkast som bokförs först när någon går vidare med det, ett fakturautkast som inget skickas från, en uppgift, en kommentar, en kalenderpost, ett projekt eller ett dokument. Den kan också ladda upp en fil till Inkorgen, där den läses av som om du laddat upp den i appen. En bokning eller ett utkast till evenemang läggs in direkt, med samma regler som i appen.

Förslag som du godkänner

En ändring med verkan, som att skicka en faktura, markera den betald, makulera den, bekräfta förslag i Bokföring eller bokföra en rättelse, utförs inte när agenten ber om den. Den kommer tillbaka som ett förslag med en referens (ref), och agenten ska visa dig vad det gäller. Först när du har sagt ja anropar agenten commit_operation med referensen, och då utförs just det förslaget, oförändrat. Säger du nej, eller är förslaget fel, avvisar agenten det med reject_operation. list_pending_operations visar vad som väntar. Ett bokfört verifikat raderas aldrig; det rättas med ett nytt.

Resten av det du kan göra i Asamla

Allt agenten kan i Bokföring utöver verktygen ovan, och det mesta övriga i Asamla (möten och protokoll, medlemmar, utskick, grupper, omröstningar med mera), nås genom två kataloger som agenten frågar efter när den behöver: list_accounting_acts för bokföringen och list_actions för resten. Varje post i katalogen beskriver vad den gör och vilka uppgifter den behöver, och körs sedan med run_accounting_act respektive run_action. Katalogerna följer med varje ny funktion, så den är den aktuella förteckningen och den här sidan behöver inte vara det.

Säkerhet

• Allt agenten läser lämnas över som data, inte som instruktioner: en rad i ett kvitto eller ett mejl kan inte få agenten att godkänna något åt dig.
• Verktygen är märkta som läsande, skrivande eller oåterkalleliga, så att din klient kan låta läsningar köra och stanna vid det som inte går att ta tillbaka.
• Agenten agerar som du. Det den gör syns i Asamla med ditt namn, och din roll avgör vad den får.

Ingår det i min plan?

Asamla i Claude och ChatGPT är en funktion i de betalda planerna (Plus och Komplett). Frågan ställs per organisation, vid varje anrop: är du medlem i flera organisationer kan en ha funktionen och en annan sakna den, och agenten får då veta det. Att lista och välja organisation fungerar alltid. Ett nytt företag börjar på Plus i sex månader utan kostnad, så anslutningen fungerar från första dagen. För föreningar är planerna pausade och anslutningen ingår. Aktuellt läge finns under Priser och Priser för företag.

Utan konto

Det finns också en öppen server för den som inte har något konto, för allmänna frågor om svensk föreningspraxis, mallar, guider och bidrag. Den når ingen organisations uppgifter. Läs mer under Hjälp och kontakt.

Hjälp

Fungerar inte inloggningen, eller vill du att något ska finnas som agenten inte kan? Skriv till support@asamla.se och berätta vilken klient du använder. Maskinläsbar sammanfattning av Asamla finns i llms.txt.