MCP-liitin

Vinssillä on etä-MCP-palvelin osoitteessa https://vinssi.ai/mcp. Lisää tuo osoite omana liittimenä. Palvelin käyttää Streamable HTTP -yhteyttä. Kirjautuminen tapahtuu OAuthilla, Clerk-palvelussa https://clerk.vinssi.ai. Sama ohje on englanniksi.

Liitin toimii sinun tililläsi ja työtilassasi. Se voi lukea työtilan, listata ja luoda projekteja, yhdistää GitHub-repositorion, julkaista sen, lukea julkaisun tilan ja build-lokit, palauttaa aiemman terveen julkaisun sekä julkaista tai poistaa Vinssi Pages -sivuja. Salaisuuksien hallintatyökaluja ei ole tarjolla. Lokitulosteista peitetään tunnetut ympäristöarvot ja tunnistettavat salaisuudet. Älä kirjoita salaisuuksia sovelluksen lokeihin. Se ei käynnistä maksua. Jos projekti tarvitsee paketin, työkalu kertoo sen ja linkittää sivulle vinssi.ai/pricing.

Vinssi osaa julkaista vain GitHub-repositorion. Julkaistu sovellus ajetaan Euroopassa. Vinssin GitHub-sovellus pitää olla asennettuna, ja sillä pitää olla oikeus nähdä repositorio. connect_repo saa arvoksi owner/name. Muun palvelun repositoriota ei voi yhdistää.

Liittimen lisääminen

Käytä palvelimen osoitteena https://vinssi.ai/mcp. Kun ohjelma avaa selaimen, kirjaudu Vinssiin ja hyväksy pyyntö.

Claude

Avaa Claudessa asetukset, sitten Connectors, ja lisää oma liitin. Liitä osoite https://vinssi.ai/mcp. Clauden paluuosoite on https://claude.ai/api/mcp/auth_callback. Claude Code käyttää lisäksi paikallista paluuosoitetta, http://localhost tai http://127.0.0.1, mikä tahansa portti, polku /callback.

ChatGPT

Ota ChatGPT:ssä sovellusten kehittäjätila käyttöön, jos tili sitä vaatii, ja lisää liitin osoitteella. Liitä https://vinssi.ai/mcp. Paluuosoite tässä vaiheessa on https://chatgpt.com/connector_platform_oauth_redirect. Hakemistoon lähetetty liitin voi näyttää myös osoitteen https://chatgpt.com/connector/oauth/{callback_id}. Tuo tunniste tulee OpenAI:n hallinnasta.

Cursor

Avaa Cursorissa asetukset, sitten MCP, ja lisää palvelin osoitteella. Liitä https://vinssi.ai/mcp. Sama osoite käy asetustiedostossa:

{
  "mcpServers": {
    "vinssi": {
      "url": "https://vinssi.ai/mcp"
    }
  }
}

Cursor avaa selaimen OAuth-kirjautumista varten. Jos ohjelma osaa lähettää vain otsikon, voit käyttää henkilökohtaista API-tunnusta. Katso API ja tunnukset.

Grok Bot

Lisää Grok Botissa oma MCP-liitin ja liitä osoite https://vinssi.ai/mcp. Jos lomake kysyy palvelimen osoitetta eikä plugin-repositoriota, tuo osoite on palvelin.

Työkalut

Työkalu	Mitä se tekee
`get_workspace`	Työtilan nimi ja jäljellä oleva hyvitys, eurosenteissä
`list_projects`, `get_project`	Projektit, tila, GitHub-repositorio ja julkinen osoite
`create_project`	Luo tyhjän projektin. Ei julkaise sitä
`connect_repo`	Yhdistää GitHub-sovelluksen näkemän repositorion muodossa `owner/name`. Korvaa aiemman yhteyden
`deploy`	Laittaa yhdistetyn GitHub-repositorion julkaisujonoon. Git-viite on valinnainen
`get_deployment`, `get_build_logs`, `list_deployments`	Tila, uusimmat build-lokirivit ja viimeisimmät julkaisut
`rollback`	Laittaa jonoon uuden julkaisun, joka palauttaa aiemman terveen julkaisun
`publish_page`	Julkaisee pyynnössä lähetetyt tiedostot ja palauttaa osoitteen
`list_pages`, `delete_page`	Listaa sivustot tai poistaa yhden

publish_page saa listan files. Jokaisessa on path ja content. encoding on utf8 (oletus) tai base64. Raja on 200 tiedostoa ja 5 MB purettua sisältöä. Yksi HTML-tiedosto tallennetaan nimellä index.html. Uusi sivusto tarvitsee nimen (name). Anna siteId, jos haluat korvata sen, mitä osoite näyttää. Edellinen versio säilyy tallessa.

get_build_logs palauttaa 200 viimeistä riviä, ellet anna arvoa tail. Enimmäismäärä on 400 riviä.

Rajat

Rajat ovat työtilakohtaisia. Ne ovat samat hallinnassa, CLI:ssä ja suorissa API-kutsuissa.

Toiminto	Raja
Julkaisu ja palautus	20 kertaa 5 minuutissa
Pages-julkaisu	60 kertaa 5 minuutissa

Kokeile paikallisesti

Käynnistä API repositoriosta (bun run dev käynnistää sen porttiin 3000) ja avaa MCP Inspector:

npx @modelcontextprotocol/inspector

Yhdistä osoitteeseen http://localhost:3000/mcp. Bearer-tunnusta varten luo tunnus komennolla vinssi tokens create ja lähetä Authorization: Bearer vinssi_.... Inspectorin OAuth lukee metatiedon osoitteesta http://localhost:3000/.well-known/oauth-protected-resource/mcp. Dokumentti osoittaa tämän ympäristön Clerk-instanssiin. Selaimessa kirjautuminen Inspectorista onnistuu, kun Clerk sallii dynaamisen asiakasrekisteröinnin ja Inspectorin näyttämän paluuosoitteen. Siihen asti käytä henkilökohtaista API-tunnusta.

Pyyntö ilman tunnusta saa vastauksen 401 ja WWW-Authenticate-otsikon, joka osoittaa metatiedon osoitteeseen.

OAuth-oikeudet ja tulosteiden rajat

OAuth-käyttöoikeustunnus tarvitsee Clerkissä myönnetyn vinssi:mcp-oikeuden. Pelkkä openid tai profile ei riitä. Istunto- ja ID-tunnuksia ei hyväksytä. Puuttuva tai virheellinen tunnus palauttaa 401; puuttuva MCP-oikeus palauttaa 403. JWT-käyttöoikeustunnuksen erikseen ilmoitetun kohdeyleisön pitää vastata MCP-osoitetta.

Määritä Clerkissä ensin CIMD. Ota DCR käyttöön vain sitä tarvitseville asiakkaille. Julkaise vinssi:mcp metatiedoissa ja myönnä oikeus asiakkaille. Jos dynaaminen asiakas ei lähetä oikeuksia, aseta oletuksiksi vinssi:mcp ja offline_access. OAuth-polku pitää testata oikeissa asiakassovelluksissa ennen julkaisua.

Usean tiedoston julkaisu vaatii juureen index.html-tiedoston. Virheellinen sisältö hylätään ennen sivuston luontia. Lokituloste on rajattu 400 riviin ja noin 64 kilotavuun. Ylisuuret viestit jätetään pois. Tunnetut ympäristöarvot ja tunnistettavat salaisuudet peitetään; älä silti kirjoita salaisuuksia sovelluksen lokeihin. Luo henkilökohtaiset API-tunnukset omassa komentorivissäsi, älä tekoälykeskustelun työkalukutsussa.