MCP-server

Anslut din AI-assistent till Matrummet via Model Context Protocol (MCP) och låt den söka recept, planera matveckan och fylla på inköpslistan åt dig.

Anslutning

Peka din MCP-klient på följande adress (transport: streamable-http):

https://mcp.matrummet.se/mcp

Servern använder OAuth 2.1 med dynamisk klientregistrering, så klienter som stödjer det ansluter helt utan förkonfiguration: du skickas till en inloggningssida, loggar in med ditt Matrummet-konto och godkänner åtkomsten. Inga API-nycklar behöver klistras in.

Exempel

Claude Code:

bash

claude mcp add --transport http matrummet https://mcp.matrummet.se/mcp

Generisk klientkonfiguration (t.ex. i en mcp.json):

json

{
  "mcpServers": {
    "matrummet": {
      "type": "http",
      "url": "https://mcp.matrummet.se/mcp"
    }
  }
}

Vad kan en agent göra?

Servern exponerar ett åttiotal verktyg som täcker hela det dokumenterade API:et:

Område	Exempel på verktyg
Recept	sök (fritext med OR-stöd), hämta, skapa, uppdatera, kopiera, gilla, räkna
Samlingar	lista, skapa, dela, lägg till/ta bort recept
Inköpslistor	skapa, lägg till recept eller egna varor, bocka av, rensa
Skafferi	lägg till/ta bort, hitta recept från skafferiet
Matplanering	hämta/spara veckoplan, byt rätt, till inköpslista
Hushåll	medlemmar, inbjudningar, anslutningskoder
Delning	delningslänkar för recept, receptböcker och samlingar
Bilder	ladda upp receptbilder

Säkerhet

Agenten agerar som du: den ser och ändrar bara det ditt konto har tillgång till (row-level security). Vid inloggningen skapas en API-nyckel för din räkning — du kan när som helst återkalla den under Inställningar → API-nycklar, vilket omedelbart stänger av agentens åtkomst.

Destruktiva verktyg (t.ex. radera recept) kräver en explicit bekräftelseflagga från agenten.

Teknisk översikt

Transport: MCP Streamable HTTP (POST /mcp)
Auktorisering: OAuth 2.1, PKCE (S256), dynamisk klientregistrering (RFC 7591)
Discovery: /.well-known/oauth-authorization-server och /.well-known/oauth-protected-resource/mcp
Underliggande API: api.matrummet.se