Skape för utvecklare

Skapes gränssnitt för integrationer är en fjärransluten MCP-server på https://skap.es/mcp, som använder Streamable HTTP. Den låter agenter förstå och redigera projekt med kartor, ljudlogik och interaktiva skärmar. Börja med Koppla din AI för att ansluta i din AI-app, eller läs Skapes agentguide för hela SDK- och skriptflödet (på engelska).

När du ska använda Skape

Använd Skape när en användare vill förklara en befintlig upplevelse, planera en ljudvandring, koppla geografiska områden till ljud eller bygga skärmar och återanvändbara komponenter med teamets uppladdade filer. Agenter kan undersöka det sparade projektet, bygga sammankopplade nodgrafer och redigera kartobjekt och skärmträd.

Uppladdning, publicering, teammedlemskap och fakturering sköts i studion. Interaktiva kartor och skärmförhandsvisningar kräver en klient som stöder MCP Apps. Verktygen beskriver sparade projekt och tillgängliga körkontrakt; de rapporterar inte en lyssnares aktuella position eller enhetstillstånd.

Autentisering och metadata

Anslut med en MCP-klient som stöder OAuths auktoriseringskodflöde med PKCE och Client ID Metadata Documents (CIMD). Skape använder inloggning i webbläsaren och användarens samtycke. Klienter som kräver dynamisk klientregistrering (DCR) kan inte ansluta.

MCP-resursens metadata identifierar MCP-resursen och auktoriseringsservern.
OAuth-serverns metadata anger utfärdare, adresser för auktorisering och tokenutbyte samt funktioner som stöds. Utfärdaren är https://skap.es/oauth/mcp.
OAuth-metadata från webbplatsens rot leder till samma servermetadata för klienter som utforskar webbplatsen.

Hämta adresserna från dessa metadata. Begär en token för MCP-resursen https://skap.es/mcp. OAuth-inloggningen ger anslutningen dess behörighet; det finns ingen API-nyckel att skapa.

Read ger skape:read och är förvalt. Det tillåter läsning av projekt och deras filer och struktur.
Read & build ger även skape:write. Det tillåter att skapa, redigera och radera innehåll i projekt inom användarens teamroll. Att radera ett helt projekt görs i studion.
Användaren väljer vilka team anslutningen får komma åt. Nya team inkluderas inte automatiskt. En token ger aldrig agenten mer åtkomst än användaren har.

Om en läsanslutning behöver bygga använder du klientens inloggningsfråga för nytt samtycke eller ansluter igen med Read & build. Den nya anslutningen börjar med en egen ångra-historik. Användaren kan minska åtkomsten eller koppla bort anslutningen på teamets sida MCP / AI i översikten.

Ett första verktygsflöde

Agenter läser och ändrar ett projekt genom att köra JavaScript eller TypeScript mot Skapes SDK, ett dokumentträd i Figmas stil (skape motsvarar Figmas figma).

Läs Skapes agentguide på engelska, initiera sedan MCP-anslutningen och hämta dess verktyg. skape_docs returnerar samma guide, rankade SDK-symboler för en sökning eller exakta typdeklarationer.
Anropa skape_list_projects. Välj användarens avsedda projekt bland de returnerade ID:na.
Läs med skape_query innan du ändrar något, till exempel skriptet return skape.root.outline(). Det körs på en kopia och sparar aldrig, så det kan också förhandsgranska en ändring.
Ändra projektet med skape_edit: projectId, en description på en mening, code och en ny idempotencyKey. Ett skript är en transaktion och ett ångra-steg. Om det kastar ett fel sparas ingenting: rätta skriptet och skicka hela igen med en ny nyckel.
Om ett nätverksfel gör resultatet osäkert försöker du igen med exakt samma argument och nyckel; en upprepning returnerar det första resultatet.

skape_undo ångrar anslutningens senaste skape_edit som ett steg (redo: true gör om det) och vägrar hellre än att skriva över något som ändrats i studion sedan dess. skape_create_project skapar ett projekt med en egen idempotensnyckel. skape_export_project ger en nedladdningslänk, giltig i en timme, till projektets .skape-project.zip, filen som studion importerar. skape_import_project gör en sådan fil till ett nytt projekt i ett team: första anropet ger en länk att ladda upp filen till, det andra importerar den. Projekt raderas i studion, inte via MCP.

Börja gratis och testa

Skapa ett Skape-konto gratis och skapa eller gå med i ett team. Gratisplanen omfattar byggande och testning, hela studion och arbete med din egen AI-assistent. Logga in från din MCP-klient och välj team och åtkomst.

Det finns ingen separat publik sandbox-adress. Skapa ett tillfälligt projekt i ditt eget team för att prova ändringar och granska de sparade resultaten. Ångra sedan ändringarna eller radera testprojektet. Det är riktiga sparade projekt med vanliga behörigheter. Använd läsåtkomst när du bara behöver undersöka ett befintligt projekt.

Mobilappen är inte offentligt släppt än. Skape hjälper deltagande team att installera testversioner för testning på plats; kontakta hello@skap.es för hjälp. Läsning och redigering av projekt via MCP sker genom servern och kräver inte mobilappen.

Resurser för agenter

llms.txt: startindex, lämpliga uppgifter och länkar till fördjupning (på engelska).
Skapes agentguide: guiden till Skapes SDK med projektets begrepp, skriptregler och praktiska exempel på engelska, även tillgänglig via skape_docs och MCP-resursen skape://sdk/guide.md.
Koppla din AI: klientinställningar, samtycke, felsökning och frånkoppling.
Hjälp och priser: aktuell tillgänglighet, kontohjälp och publiceringsplaner.