Uporaba API-ja in MCP

MetaOS uporabljajte iz svojega asistenta AI prek MCP ali iz svoje kode prek GraphQL.

MCP

Za asistente AI: Claude Code, Claude, Codex, ChatGPT

123 orodij

Povežite asistenta

GraphQL

Za skripte in aplikacije

POST /graphql

Uporabite API

MCP

MetaOS je strežnik MCP. Povežite z njim asistenta AI, na primer Claude, Codex ali ChatGPT, in asistent bo lahko v vašem imenu iskal in urejal epizode, ljudi, snemanja in oddaje Ogrodja ter njegove dokumente Google in datoteke v Koofru.

1
Dodajte MetaOS v Claude Code
V terminalu; --scope user ga doda v vse vaše projekte.
Terminal
```
claude mcp add --transport http --scope user ogrodje https://ogrodje.si/mcp
```
Prijavite se
V Claude Code zaženite /mcp, izberite ogrodje in nato Authenticate. Brskalnik odpre prijavo v MetaOS, kjer se prijavite z Discordom ali Googlom.
Postanite del ekipe
MCP je za ekipo Ogrodja. S prijavo postanete član; v ekipo vas doda skrbnik Ogrodja, do takrat pa MetaOS asistentovo prijavo zavrne. Ko ste v ekipi, se prijavite znova.
Vprašajte
Na primer: »Katere epizode so v produkciji?« ali »Kdo snema na naslednjem snemanju?« Asistent izmed spodnjih orodij izbere tista, ki jih potrebuje, in vas, razen če ste jih že dovolili, vpraša, preden katero uporabi.
Posodabljajte njegova orodja
Orodja MetaOS so v različici 1.1.0 in se spreminjajo skupaj z MetaOS. Asistent obdrži tista, ki jih je dobil, zato ima starejša, kadar katerega od spodaj naštetih ne najde ali kadar MetaOS zavrne, kako ga kliče. Claude Code jih znova dobi v novi seji ali v /mcp: izberite ogrodje in nato Reconnect.

Drugi odjemalci MCP, ki se prijavljajo z OAuth, na primer MCP Inspector, se povežejo na https://ogrodje.si/mcp.

GraphQL

Strani MetaOS dobijo, kar prikazujejo, iz njegovega API-ja GraphQL, in vaše skripte in aplikacije ga lahko sprašujejo prav tako.

Končna točka: POST https://ogrodje.si/graphql, z JSON: query in njegove variables
Napake: V telesu odgovora, s statusom 200
Shema: Z introspekcijo, za odjemalce GraphQL, in opisana polje za poljem v schema.graphqls na GitHubu
Omejitve: 15 ravni globine in 300 polj na poizvedbo

Brez žetona

Kar je javno, deluje za vsakogar: objavljene epizode in ljudje na njih. To je tudi vse, kar episodes in people vrneta komur koli brez žetona.

Zadnje tri objavljene epizode

curl -s https://ogrodje.si/graphql \
  -H 'Content-Type: application/json' \
  -d '{"query":"{ releasedEpisodes(limit: 3) { code title airedDate youtubeUrl } }"}'

Z žetonom

Vse drugo je za ekipo. Potrebujete žeton člana ekipe z metaos:read, za spremembe pa še z metaos:write. Skripte še nimajo svoje prijave, zato uporabite žeton iz prijave v MetaOS, ki ima oba.

Vaš žetonvelja 5 minut

Prijavite se desno zgoraj in tukaj boste kopirali svojega.

Kdo ste za MetaOS

curl -s https://ogrodje.si/graphql \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"query":"{ me { username person { name } } }"}'

Komentar k S05E08, z besedilom v spremenljivkah, da ničesar ni treba ubežati

curl -s https://ogrodje.si/graphql \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"query":"mutation ($ref: String!, $body: String!) { commentOnEpisode(ref: $ref, body: $body) { id createdAt } }","variables":{"ref":"S05E08","body":"Hello from the API"}}'

Orodja

123

Kaj lahko asistent naredi prek MCP v vašem imenu, v različici 1.1.0. Izbere tista, ki jih potrebuje, in vas najprej vpraša, razen če ste jih že dovolili.

Iskanje epizode, ideje, ljudje in snemanja hkrati

search: Poišče epizode, ljudi in snemanja po kodi, imenu ali besedah v naslovih in povzetkih; koda najde samo svojo epizodo

Epizode od ideje do objave

list_episodes: Seznam epizod, najnovejše najprej, po želji le tistih z določenim stanjem
get_episode: Epizoda po kodi ali ID-ju, s povzetki
create_episode: Doda epizodo; ta začne kot ideja, ki je lahko brez kode, predlagatelj pa ste vi, razen če navedete koga drugega
set_episode_recommended_by: Nastavi ali počisti predlagatelja epizode
update_episode: Spremeni kodo, naslov, nadomestne naslove za teste A/B, povzetke ali datume epizode
set_episode_status: Premakne epizodo skozi njen življenjski cikel, od ideje do objave, korak za korakom
set_episode_link: Nastavi ali počisti povezavo do YouTuba, Spotifyja ali Apple Podcasts ali eno od njenih štirih na Patreonu: celotno epizodo ali bonus, kot video ali samo zvok; vsaka je tudi v njeni distribuciji
delete_episode: Izbriše epizodo; mogoče jo je obnoviti
restore_episode: Vrne izbrisano epizodo, z ljudmi, povezavami, snemanjem in oddajo; pod novo kodo, če je njena zasedena

Distribucija kje je epizoda izšla, ko je bila objavljena: njene povezave in objave, ki jo promovirajo

list_episode_distributions: Kje je epizoda izšla: njene povezave, nato objave, vsaka s predogledom svoje strani
list_distributions: Kje so izšle vse epizode, najnovejše najprej, na primer ta teden ali na LinkedInu
add_episode_distribution: Zabeleži objavo, ki promovira epizodo, po njenem URL-ju, na primer na Discordu, LinkedInu ali Redditu; MetaOS pridobi njen predogled
update_episode_distribution: Spremeni URL, kanal, opombo ali naslov objave ali kdaj je izšla
remove_episode_distribution: Odstrani objavo z epizode; če je to ena od njenih povezav, se počisti tudi na epizodi
refresh_distribution_preview: Znova pridobi predogled objave, na primer ko se je spremenila

Ljudje voditelji, gostje, producenti in vi

list_people: Seznam vseh ljudi
create_person: Doda osebo
set_person_email: Nastavi ali počisti e-poštni naslov osebe; računi, ki se prijavljajo z njim, se povežejo z njo
set_person_bio: Nastavi ali počisti vrstico o tem, kdo je oseba, na primer njeno vlogo in podjetje
set_person_link: Nastavi ali počisti njeno domačo stran, LinkedIn, Twitter/X, Instagram ali Facebook
delete_person: Izbriše osebo; dokler je ne obnovite, izgine z epizod, na katerih je, in s tistih, ki jih je predlagala
restore_person: Vrne izbrisano osebo, z vlogami in epizodami, ki jih je predlagala; z drugim e-poštnim naslovom ali brez njega, če je njen zaseden
list_episode_people: Ljudje na epizodi in njihove vloge
assign_person_to_episode: Dodeli osebi vlogo na epizodi: voditelj, sovoditelj, gost, producent, svetovalec, oblikovalec ali kandidat za nekoga, ki bi lahko bil gost
remove_person_from_episode: Odstrani osebo z epizode: eno od njenih vlog ali vse
confirm_guest: Kandidata naredi za gosta epizode, ko privoli
list_person_episodes: Epizode, na katerih je oseba, in njene vloge
whoami: Kot kdo ste prijavljeni: vaš račun in oseba, s katero je povezan; ter različica orodij MetaOS
my_episodes: Epizode, na katerih ste vi, in vaše vloge
list_accounts: Računi, ki jih MetaOS pozna, in osebe, ki jim pripadajo, ali le tisti, ki niso povezani z nikomer
link_account: Poveže račun z osebo, ki ji pripada, da so njegovi komentarji in spremembe pod njenim imenom, tudi pretekli; to sme le Oto
unlink_account: Odveže račun od osebe, na primer če je povezan z napačno; to sme le Oto

Snemanja dnevi, ko snemamo epizode

list_sessions: Seznam vseh snemanj, najnovejša najprej
create_session: Doda snemanje: datum, ime, lokacijo in naslov
update_session: Spremeni datum, ime, lokacijo ali naslov snemanja
delete_session: Izbriše snemanje; njegove epizode ostanejo
restore_session: Vrne izbrisano snemanje, z njegovimi epizodami
list_session_episodes: Epizode snemanja
set_episode_session: Premakne epizodo v snemanje ali iz njega

Razprava komentarji k epizodam, idejam in snemanjem, v Markdownu, kot na GitHubu

list_episode_comments: Komentarji k epizodi ali ideji, najstarejši najprej, s tem, kdo jih je napisal in kdaj
list_session_comments: Komentarji k snemanju, najstarejši najprej
comment_on_episode: Komentira epizodo ali idejo v vašem imenu, v Markdownu
comment_on_session: Komentira snemanje v vašem imenu, v Markdownu
edit_comment: Spremeni besedilo enega od vaših komentarjev; prikazan je kot urejen
delete_comment: Izbriše enega od vaših komentarjev; zgodovina ohrani, da je obstajal

Oddaje serije epizod, kot je Borderless

list_shows: Seznam vseh oddaj
get_show: Oddaja po imenu
create_show: Doda oddajo, z epizodami v slovenščini, razen če navedete drug jezik
update_show: Preimenuje oddajo ali spremeni njeno barvo ali jezik, v katerem so njene epizode
delete_show: Izbriše oddajo; njene epizode ostanejo
restore_show: Vrne izbrisano oddajo, z njenimi epizodami; pod novim imenom, če je njeno zasedeno
list_show_episodes: Epizode oddaje
set_episode_show: Premakne epizodo v oddajo ali iz nje

Google Drive mapa Ogrodja

list_drive_folder: Kaj je v mapi
search_documents: Poišče dokumente Google po besedah v naslovu ali besedilu
read_document: Prebere dokument Google, kot Markdown
list_episode_documents: Dokumenti Google epizode in njenega snemanja
link_episode_document: Poveže dokument Google z epizodo, na primer dokument za njeno pripravo
unlink_episode_document: Odveže dokument Google od epizode; dokument ostane v Drivu
list_session_documents: Dokumenti Google snemanja
link_session_document: Poveže dokument Google s snemanjem, na primer načrt snemalnega dne
unlink_session_document: Odveže dokument Google od snemanja; dokument ostane v Drivu
match_episode_documents: Poveže dokumente v mapi z epizodami po kodi v naslovu; le poroča, razen če mu naročite, naj jih poveže

Koofr mape, ki jih z botom Ogrodja delijo drugi

list_koofr_places: Mape, ki jih z botom Ogrodja delijo drugi, in ali jih sme spreminjati
list_koofr_folder: Kaj je v mapi
search_koofr: Poišče datoteke in mape po imenu
read_koofr_file: Prebere besedilno datoteko: txt, md, csv, json, srt in podobne
upload_koofr_file: Naloži datoteko; tisto z enakim imenom zamenja le na zahtevo
create_koofr_folder: Ustvari mapo
move_koofr_file: Premakne ali preimenuje datoteko ali mapo; kar je povezano z njo, ostane povezano
list_episode_koofr_folders: Mape v Koofru epizode in njenega snemanja
link_episode_koofr_folder: Poveže mapo v Koofru z epizodo, na primer tisto z njenimi posnetki
unlink_episode_koofr_folder: Odveže mapo v Koofru od epizode; mapa ostane v Koofru
list_session_koofr_folders: Mape v Koofru snemanja
link_session_koofr_folder: Poveže mapo v Koofru s snemanjem
unlink_session_koofr_folder: Odveže mapo v Koofru od snemanja; mapa ostane v Koofru

Dropbox mape, ki jih z botom Ogrodja delijo drugi, kot je Artwork

list_dropbox_places: Mape, ki jih z botom Ogrodja delijo drugi, in ali jih sme spreminjati
list_dropbox_folder: Kaj je v mapi
search_dropbox: Poišče datoteke in mape po imenu
read_dropbox_file: Prebere besedilno datoteko: txt, md, csv, json, srt in podobne
view_dropbox_image: Pogleda sliko, na primer grafiko za epizodo
upload_dropbox_file: Naloži datoteko; tisto z enakim imenom zamenja le na zahtevo
create_dropbox_folder: Ustvari mapo
move_dropbox_file: Premakne ali preimenuje datoteko ali mapo
list_episode_dropbox_folders: Mape v Dropboxu epizode in njenega snemanja
link_episode_dropbox_folder: Poveže mapo v Dropboxu z epizodo, na primer tisto z njeno grafiko
unlink_episode_dropbox_folder: Odveže mapo v Dropboxu od epizode; mapa ostane v Dropboxu
list_session_dropbox_folders: Mape v Dropboxu snemanja
link_session_dropbox_folder: Poveže mapo v Dropboxu s snemanjem
unlink_session_dropbox_folder: Odveže mapo v Dropboxu od snemanja; mapa ostane v Dropboxu

Patreon Patreon Ogrodja: osnutki ter zvok ali video epizode, ki jih v Patreonu objavi človek

list_patreon_tiers: Ravni članstva, najcenejše najprej, s cenami in podporniki
list_patreon_members: Člani, najprej podporniki: njihov status, ravni, prispevek, koliko so dali skupaj in njihovo zadnje plačilo
list_patreon_posts: Objave, ki so izšle, najnovejše najprej, ali tiste z določenimi besedami v naslovu
list_patreon_drafts: Osnutki, tudi načrtovani, najprej nazadnje urejeni, s tem, kje jih uredite
get_patreon_post: Objava, izšla ali osnutek, z besedilom in tem, kdo jo sme videti
get_patreon_post_media: Povezave za prenos zvoka (MP3, kot je bil naložen) ali videa (njegov najboljši MP4) objave, za približno en dan
create_patreon_draft: Pripravi osnutek objave, za vse, za vse podpornike ali za nekatere ravni; vidi ga le ekipa
update_patreon_post: Spremeni naslov ali besedilo objave ali kdo jo sme videti
set_patreon_post_media: Naloži eno od datotek epizode v MetaOS v osnutek, kot objavo podkasta ali videa
set_patreon_post_image: Nastavi sličico objave, eno od slik epizode v MetaOS
prepare_patreon_post: Preveri, ali je osnutek pripravljen, da ga človek objavi v Patreonu: njegov naslov in obdelan zvok ali video
delete_patreon_post: Izbriše objavo, na primer osnutek, ki ni več potreben
get_patreon_job: Kako napreduje sprememba v Patreonu, na primer nalaganje: končana, ni uspela in zakaj, ali čaka na vrsto ali na ponovni poskus

Slike sličice, naslovnice in avatarji, ki jih vidijo vsi, na media.ogrodje.si

set_episode_image: Sliko iz Dropboxa ali Koofra nastavi za sličico epizode, sličico B ali C (za nadomestne naslove) ali spletno sliko, 1920 × 1080, ali za njeno naslovnico, 3000 × 3000
remove_episode_image: Odstrani eno od slik epizode
list_episode_images: Sličice, spletna slika in naslovnica epizode, z njihovimi URL-ji
set_person_avatar: Sliko iz Hygrapha, Dropboxa ali Koofra nastavi za avatar osebe
remove_person_avatar: Odstrani avatar osebe
get_person_avatar: Avatar osebe, z njegovimi URL-ji

Video in zvok celoten video in zvok epizode ter njeni bonusi, naloženi na njeni strani, le za ekipo

list_episode_media: Video in zvočne datoteke epizode, s tem, kaj je v vsaki (dolžina, kodeki, ločljivost), in povezavo za prenos, ki velja eno uro
update_episode_media: Spremeni naslov datoteke ali kaj je, na primer bonus video, ki je v resnici celoten video
remove_episode_media: Odstrani video ali zvočno datoteko z epizode in jo izbriše

Prepisi kaj je izrečeno v videu in zvoku epizode, kot sta slišala Googlov Speech-to-Text ali Soniox, v trajnem poteku dela

transcribe_episode: Prepiše celoten zvok ali video epizode ali drugo njeno datoteko, z Googlovim Speech-to-Text ali s Sonioxom; ko je ponudnik zaseden, počaka na vrsto
list_transcriptions: Prepisovanja, najnovejša najprej: v čakalni vrsti, v teku, končana, neuspela ali preklicana, po ponudniku ali epizodi
get_transcription: Eno prepisovanje po ID-ju, kakršno je zdaj, da ga spremljate do konca
cancel_transcription: Ustavi prepisovanje, ki teče, in z njim tudi ponudnikovo
get_episode_transcript: Prepisi epizode, od vsakega ponudnika, s časovnimi oznakami in govorci, kjer jih loči, ter kako napredujejo njena prepisovanja v teku
remove_transcript: Odstrani enega od prepisov epizode in njegovo besedilo

Zgodovina kdo je kaj spremenil in kdaj ter obnova izbrisanega

get_history: Vsaka sprememba epizode, osebe, snemanja ali oddaje, tudi njihove razprave, s tem, kdaj in kdo
list_recent_changes: Zadnje spremembe vsega
list_deleted: Izbrisane epizode, ljudje, snemanja in oddaje, s tem, kdaj in kdo, za obnovo
restore_link: Vrne odstranjeno vlogo, dokument Google ali mapo v Koofru ali Dropboxu, iz spremembe, ki jo je odstranila