WebbiteMCP
Vad är MCP?
MCP (Model Context Protocol) är ett öppet, standardiserat protokoll som låter AI-assistenter och andra agentbaserade klienter anropa verktyg och läsa data från externa tjänster — på samma sätt som REST-API:er gör det möjligt för vanliga program att prata med en tjänst. Kommunikationen sker via JSON-RPC över HTTP.
Genom att koppla en MCP-kompatibel AI-klient till Bricks MCP-server kan du be din AI-assistent att söka efter filer, läsa och redigera dokument, organisera mappar, hantera delningar med mera — direkt med naturligt språk, utan att du själv behöver klicka dig fram i Brick HQ.
Vad klienten får göra styrs av vilka så kallade scopes den beviljats: brick ger läsåtkomst och brick:manage ger även rättighet att skapa, ändra och radera.
Tillgängliga verktyg
Brick erbjuder följande verktyg för din MCP-kompatibla AI-klient:
Filer och mappar
| Verktyg | Beskrivning |
|---|---|
list_folder | Listar det direkta innehållet i en mapp. Utelämna både sökväg och nod-id för att lista kontots rot. |
get_metadata | Hämtar metadata för en fil eller mapp: storlek, MIME-typ, tidsstämplar, versions-etag och sökväg. |
read_file | Läser ett radnumrerat utsnitt av en textfils innehåll (i stil med cat -n). |
write_file | Gör en exakt sök-och-ersätt-ändring i en textfils innehåll. |
replace_file | Skriver över en hel fils innehåll. Landar som en ny version — det tidigare innehållet går fortfarande att återställa via list_file_revisions / restore_file_revision. |
create_file | Skapar en ny textfil med angivet innehåll. |
create_folder | Skapar en ny mapp. |
delete | Flyttar en fil eller mapp till papperskorgen (mjuk radering). |
copy | Kopierar en fil eller mapp till samma eller en annan mapp; originalet lämnas orört. |
move | Byter namn på och/eller flyttar en fil eller mapp. |
get_download_link | Skapar en kortlivad länk för att ladda ner en fils aktuella innehåll utan ytterligare autentisering. |
Sök
| Verktyg | Beskrivning |
|---|---|
search | Söker efter filer och mappar baserat på namn i hela kontot. |
list_recent | Listar nyligen uppdaterade filer i hela kontot. |
list_largest | Listar de största filerna i kontot, störst först — praktiskt för att hitta vad som går att städa bort. |
Papperskorg
| Verktyg | Beskrivning |
|---|---|
list_trash | Listar objekt som just nu ligger i papperskorgen, senast raderade först. |
restore_from_trash | Återställer en raderad fil eller mapp (och, för en mapp, allt som ligger under den) till en aktiv plats igen. |
empty_trash | Raderar permanent alla objekt i papperskorgen som anroparen får ändra. Går inte att ångra. |
Versionshistorik
| Verktyg | Beskrivning |
|---|---|
list_file_revisions | Listar en fils versionshistorik, senaste först. |
restore_file_revision | Gör en äldre version av en fil till den aktiva igen. |
Delning
| Verktyg | Beskrivning |
|---|---|
create_shared_link | Skapar en publik länk till en fil eller mapp. Alla med länken kan komma åt den (skrivskyddat som standard) utan ett eget konto. |
share_with_user | Delar en fil eller mapp direkt med en annan medlem i kontot. |
list_shared_links | Listar publika delningslänkar som anroparen skapat, valfritt begränsat till en viss fil eller mapp. |
get_shared_link_metadata | Hämtar detaljer om en delningslänk: mottagare, utgångsdatum och vilken fil/mapp den pekar på. |
list_incoming_share_senders | Listar de kontomedlemmar som har delat något med anroparen, en post per person med antal delade objekt. |
list_incoming_shares | Listar vad en specifik kontomedlem har delat med anroparen. |
Konto
| Verktyg | Beskrivning |
|---|---|
who_am_i | Rapporterar anroparens egen identitet och åtkomst: konto-id, användar-id, e-post och beviljade scopes. |
get_usage_and_quota | Hämtar lagringsanvändning och kvot för kontot, samt en uppdelning av anroparens egen användning per medietyp. |
get_activity_log | Hämtar kontots granskningslogg för fil- och kontohändelser. |
Att ansluta till Bricks MCP-server
Bricks MCP-server nås på https://api.brick.wbite.net/v1/mcp och autentiseras med OAuth2/OIDC. För att din MCP-klient ska kunna logga in och få en åtkomsttoken behöver du först registrera den som en OIDC-klient på kontot i Account HQ.
Så här skapar du en OIDC-klient för din MCP-klient:
- Logga in på Account HQ.
- Klicka på profilikonen längst upp till höger för att öppna profilmenyn.
- Under rubriken Account i menyn, klicka på OIDC Clients.
- Klicka på knappen för att lägga till en ny klient.
- Fyll i formuläret:
- Ge klienten ett namn, t.ex. namnet på din AI-klient.
- Under Client type, välj Public — MCP-klienter använder Code-flödet med PKCE och behöver ingen client secret.
- Under Account mode, välj Single-mode.
Det är viktigt: en åtkomsttoken från Bricks MCP-server är alltid knuten till ett enda konto, så klienten måste tvinga fram ett kontoval vid inloggning istället för att ge åtkomst till alla dina konton på en gång. - Under Redirect URIs, ange den redirect-URI som din MCP-klient visar för dig under dess egen anslutningsprocess. Den måste stämma exakt överens, annars nekas inloggningen.
- Under Scopes, bocka i
accounts,brickochbrick:manage. Dessa tre täcker allt MCP-servern erbjuder ovan —accountsför kontoinformation,brickför läsåtkomst ochbrick:manageför att även kunna skapa, ändra och radera.
- Klicka på knappen Create client.
- Kopiera Client ID som visas och klistra in det i din MCP-klients inställningar tillsammans med serveradressen
https://api.brick.wbite.net/v1/mcp. Eftersom klienten är av typen Public visas ingen client secret — den behövs inte heller.
När du därefter ansluter i din MCP-klient skickas du till Account HQ för att logga in och godkänna åtkomsten, precis som vid vanlig OAuth2-inloggning.