AI Coding Tools

Laat je AI-assistent de mindzieAPI direct begrijpen

Moderne AI-coding tools zoals Claude Code, Cursor, Windsurf en GitHub Copilot kunnen documentatie rechtstreeks van URL's lezen. Wij bieden LLM-geoptimaliseerde documentatiebestanden die je AI-coding assistent volledige kennis van de mindzieAPI geven.

Snelle Referentie

Kopieer deze URL's om je AI-coding tools te configureren:

Resource URL Beste Voor
Volledige Documentatie https://docs.mindziestudio.com/llms-full.txt Compleet API begrip (~120K tokens)
Documentatie Index https://docs.mindziestudio.com/llms.txt Snelle referentie met links naar pagina's

Claude Code

Claude Code kan documentatie benaderen via WebFetch of aangepaste instructies.

Methode 1: WebFetch (Aanbevolen)

In een Claude Code sessie, haal de volledige documentatie op:

Please read the mindzieAPI documentation from https://docs.mindziestudio.com/llms-full.txt

Claude zal de volledige API-documentatie ophalen en lezen. Je kunt dan vragen stellen over endpoints, authenticatie, request/response formaten en codevoorbeelden ontvangen.

Methode 2: Toevoegen aan Projectinstructies

Voor blijvende toegang over sessies heen, voeg toe aan het projectbestand CLAUDE.md of .claude/settings.json:

## mindzieAPI Referentie

Wanneer je werkt met de mindzieAPI, haal documentatie op van:
https://docs.mindziestudio.com/llms-full.txt

Dit bevat de volledige API-documentatie inclusief:
- Authenticatie (Bearer tokens, API keys)
- Alle endpoints (tenants, users, projecten, datasets, blocks, dashboards)
- Request/response formaten
- Codevoorbeelden in meerdere talen

Voorbeeld Prompts

Zodra Claude de documentatie heeft, kun je vragen stellen zoals:

  • "Hoe autenticeer ik met de mindzieAPI?"
  • "Schrijf Python-code om een nieuwe dataset aan te maken"
  • "Wat is het endpoint om een block uit te voeren?"
  • "Laat zien hoe ik een CSV-bestand upload naar een project"

Cursor IDE

Cursor kan documentatie indexeren met de @docs functie voor directe toegang tijdens het coderen.

Installatiestappen

  1. Open Cursor Settings (Cmd/Ctrl + ,)
  2. Ga naar Features > Docs
  3. Klik op Add new doc
  4. Voer URL in: https://docs.mindziestudio.com/llms-full.txt
  5. Geef het de naam: mindzieAPI

Gebruik

Verwijs naar de documentatie in Cursor chat:

@mindzieAPI Hoe autenticeer ik API-verzoeken?
@mindzieAPI Schrijf een functie om alle projecten in een tenant te tonen

Windsurf

Windsurf ondersteunt externe documentatiebronnen voor AI-geassisteerd coderen.

Installatie

  1. Open Windsurf instellingen
  2. Ga naar de knowledge base of documentatiesectie
  3. Voeg https://docs.mindziestudio.com/llms-full.txt toe als externe bron

Gebruik

Tijdens het coderen zal Windsurf automatisch de mindzieAPI documentatie raadplegen voor nauwkeurige suggesties en aanvullingen.


GitHub Copilot

Hoewel Copilot niet direct URL's ophaalt, kun je context bieden via projectbestanden.

Optie 1: Includen in Project

Maak een docs/mindzieAPI.md bestand aan in je project met de API-referentie. Copilot gebruikt dit als context wanneer je in dat project werkt.

Optie 2: Copilot Chat

Plak in GitHub Copilot Chat belangrijke gedeelten van de documentatie of verwijs naar de URL:

Using the mindzieAPI documented at https://docs.mindziestudio.com/llms-full.txt,
write a Python class to manage datasets.

Cody (Sourcegraph)

Cody kan externe documentatie indexeren voor contextbewuste assistentie.

Installatie

  1. Open Cody instellingen
  2. Voeg https://docs.mindziestudio.com/llms-full.txt toe aan je contextbronnen
  3. De documentatie zal beschikbaar zijn tijdens je codesessies

Generiek LLM Gebruik

Voor elk LLM interface (ChatGPT, Claude web, etc.) kun je:

  1. Eerst de index ophalen: Bezoek https://docs.mindziestudio.com/llms.txt om de documentatiestructuur te zien
  2. Volledige docs krijgen: Kopieer de inhoud van https://docs.mindziestudio.com/llms-full.txt in je LLM-context
  3. Vragen stellen: De LLM begrijpt nu de volledige mindzieAPI

Wat is Inbegrepen

De LLM-documentatie dekt alle mindzieAPI mogelijkheden:

Categorie Dekking
Authenticatie API keys (Globaal en Tenant), Bearer tokens, scopes, beveiligingsbest practices
Tenants Multi-tenant beheer, aanmaken, updates, verwijderen met safeguards
Users Globale operaties, tenant-gebonden operaties, rollen en permissies
Projecten CRUD operaties, caching, gebruikersrechten, import/export (.mpz bestanden)
Datasets Aanmaak, CSV/XES import, updates, kolommapping, bestandsformaten
Blocks Analyse blocks, uitvoering, resultaat ophalen, blocktypes
Dashboards Beheer, paneelconfiguratie, delen en publieke URL's
Enrichments Pipelines, Python notebook integratie, uitvoering
Actions Uitvoeren van benoemde acties, ping endpoints, uitvoeringsgeschiedenis
Execution Async jobbeheer, wachtrij operaties, status tracking

Context Window Overwegingen

Verschillende AI-modellen hebben verschillende contextlimieten. Zo passen onze documentatiebestanden:

Model Context Limiet llms-full.txt Aanbeveling
Claude Opus 4 200K tokens Past (~120K) Gebruik volledige documentatie
Claude Sonnet 200K tokens Past (~120K) Gebruik volledige documentatie
GPT-4 Turbo 128K tokens Strakke pasvorm Gebruik volledige documentatie
GPT-4o 128K tokens Strakke pasvorm Gebruik volledige documentatie
Claude Haiku 200K tokens Past (~120K) Gebruik volledige documentatie
Gemini Pro 128K tokens Strakke pasvorm Mogelijk index + specifieke pagina's nodig
GPT-3.5 16K tokens Te groot Gebruik index, haal specifieke pagina's op

Voor Kleinere Contextvensters

Als jouw model beperkte context heeft:

  1. Gebruik llms.txt (de index) om de API-structuur te begrijpen
  2. Identificeer welke secties je nodig hebt
  3. Haal individuele markdown-bestanden op van /docs-master/mindzieAPI/{category}/{page}/page.md

Bestandsformaten

URL Formaat Grootte Tokens
/llms.txt Markdown (index) ~6 KB ~1.5K
/llms-full.txt Markdown (compleet) ~470 KB ~120K
/docs-master/.../*.md Markdown (individuele pagina's) 2-15 KB elk ~500-4K elk

Documentatie Actueel Houden

De LLM-documentatie wordt opnieuw gegenereerd bij elke update van de API-documentatie. De bestanden bevatten een tijdstempel met de laatste generatie.

Voor de meest actuele documentatie moet je AI-tool verse kopieën ophalen in plaats van deze oneindig te cachen.


MCP Server Integratie

Voor geavanceerde AI-tool integratie biedt de mindzieAPI een MCP (Model Context Protocol) server waarmee AI-assistenten programmatic met mindzieStudio kunnen communiceren.

De MCP server bevat tools zoals mindzie_list_block_types met een unified categorieparameter die alle blocktypes (filters, calculators en enrichments) met volledige metadata in één oproep retourneert.

Bekijk MCP Server Documentatie


Volgende Stappen

Klaar om met AI-ondersteund coderen te beginnen? Probeer het volgende:

  1. Richt je AI-coding tool op https://docs.mindziestudio.com/llms-full.txt
  2. Vraag: "Hoe autenticeer ik met de mindzieAPI?"
  3. Verzoek: "Schrijf Python-code om alle projecten te tonen"
  4. Bouw: Complete integraties met AI-gegenereerde code

Voor menselijk leesbare documentatie, zie de Quick Start Guide of verken de volledige API Referentie.