Za developere

MCP za AI agente

CodeSensei ima MCP server preko kojeg AI agent (Claude, ChatGPT, Cursor, Claude Code…) u ime učitelja ili autora stvara tečajeve, lekcije, zadatke s testovima, riješene primjere i sadržaj učionica. Sve što agent napravi sprema se kao skica koju pregledaš prije objave.

Spajanje

Claude.ai, ChatGPT i ostale aplikacije

Dodaj custom connector s adresom https://www.codesensei.eu/mcp, autentifikacija Sign in now (OAuth). Otvorit će se CodeSensei – prijavi se i klikni Dopusti. Povezane aplikacije vidiš i opozivaš na stranici AI agenti.

Claude Code i skripte (token)

Na stranici AI agenti stvori token pa:

claude mcp add --transport http codesensei https://www.codesensei.eu/mcp \
  --header "Authorization: Bearer TVOJ_TOKEN"

OAuth metapodaci: https://www.codesensei.eu/.well-known/oauth-protected-resource/mcp i https://www.codesensei.eu/.well-known/oauth-authorization-server.

Struktura podataka

Svi ID-jevi su javni, nepredvidivi nizovi (npr. k3j9xq2mw7ab) – nikad brojevi iz baze.

Jezik (Language)            id, name
 └─ Tečaj (Course)          id, title, description, difficulty 1–5, status, visibility
     └─ Lekcija (Lesson)    id, title, description (teorija), video_link, quiz_url, order, status
         └─ Zadatak (Task)  id, title, description, input, output, difficulty 1–5, points 1–100,
                            example (riješeni primjer), status (active | awaiting_approval)
             ├─ Test primjeri   input (stdin) → expected_output (stdout)
             └─ Rješenje        solution (vidi ga samo autor)

Učionica (Classroom)        id, name, timezone
 ├─ Aktivnost (Assignment)  id, title, topic, instructions, editor, mode, max_points,
 │                          available_from, due_at, max_attempts, hints[], reference_solution,
 │                          ai_help_level, ai_review_enabled, teacher_review_required, status
 ├─ Materijal (Material)    id, title, topic, description, resource_url, status
 └─ Objava (Announcement)   id, title, body, povezane aktivnosti i materijali, status

Statusi

• Tečaj / lekcija: draft → published (objavljuje administrator). Javno su vidljivi samo objavljeni tečajevi s vidljivošću public.
• Zadatak: awaiting_approval dok ga administrator ne odobri, zatim active. Svaka izmjena ga vraća na čekanje.
• Sadržaj učionice: draft/hidden dok ga učitelj ne objavi (ili agent s publish=true kad to izričito tražiš).

Editori aktivnosti

• text – Slobodan odgovor / datoteke
• python – Python (editor + pokretanje)
• cpp – C++ (editor + pokretanje)
• javascript – JavaScript (editor + pokretanje)
• makecode – MakeCode (rad u Labsu, predaja .hex ili poveznice)

Pravila pristupa

Agent nikad ne vidi više od korisnika koji ga je spojio:

• Tečajevi: objavljeni javni tečajevi, tvoji vlastiti (i skice) te objavljeni tečajevi koje si otključao kodom. Tuđi privatni tečajevi, tečajevi s kodom koje nisi otključao i tuđe skice nisu dostupni.
• Lekcije: samo objavljene (neobjavljene vidi samo vlasnik tečaja).
• Zadaci: aktivni javni zadaci i tvoji vlastiti. Tuđi privatni i neodobreni zadaci nisu dostupni; test primjere i rješenje vidiš samo za svoje zadatke.
• Pisanje: lekcije samo u tvoje tečajeve, zadaci u tvoje lekcije ili u objavljene javne lekcije, izmjene samo tvojih zadataka.
• Učionice: samo one u kojima si aktivan učitelj; arhivirane samo za čitanje. Agent ne vidi imena učenika, predaje ni ocjene.
• Tokeni agenta rade samo na /mcp i ne daju pristup ostatku API-ja.

Alati

Tečajevi, lekcije i zadaci

Učionice

* obavezan parametar

Primjeri

Upute agentu

• „Na CodeSenseiju napravi tečaj Python za početnike s 5 lekcija; u svakoj objasni gradivo, dodaj 1 riješeni primjer i 3 zadatka s test primjerima.”
• „U učionici 2.b pripremi radionicu o petljama: materijal s objašnjenjem, 3 Python zadatka sa savjetima i točnim rješenjem i grupnu objavu koja ih povezuje. Ništa ne objavljuj.”

Poziv alata (JSON-RPC)

POST https://www.codesensei.eu/mcp
Authorization: Bearer TVOJ_TOKEN
Content-Type: application/json

{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
 "params": {"name": "create_task", "arguments": {
   "lesson_id": "k3j9xq2mw7ab",
   "title": "Zbroj dva broja",
   "description": "Učitaj dva cijela broja i ispiši njihov zbroj.",
   "difficulty": 1, "points": 10,
   "solution": "a = int(input())\nb = int(input())\nprint(a + b)",
   "test_cases": [
     {"input": "2\n3", "expected_output": "5"},
     {"input": "-4\n4", "expected_output": "0"}
   ]}}}