World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 97 tools.
Runs in the cloud✓ service owner · worldmonitor.app
İTÜ MCP
What it does
İTÜ Ninova, OBS, Portal, kampüs servisleri ve kütüphane için MCP sunucusu
- Connects Runs on your computer
- Account or key Needs NINOVA_PASSWORD, NINOVA_LIBRARY_ID, NINOVA_LIBRARY_PIN
- Category Other
Install
Pick the AI app you use, then copy the settings.
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 15, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a İTÜ MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Let AI install it
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server İTÜ MCP for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "itu": { "command": "uvx", "args": [ "itu-mcp" ], "env": { "NINOVA_PASSWORD": "your-value", "NINOVA_LIBRARY_ID": "your-value", "NINOVA_LIBRARY_PIN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For NINOVA_PASSWORD, NINOVA_LIBRARY_ID, NINOVA_LIBRARY_PIN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the İTÜ MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install uv (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
uv --version- A version number such as uv … = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
uv --versionInstall once; it works for everything that needs uv
Sign up and create a İTÜ MCP key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open the Claude desktop app’s settings file
SettingsDeveloperEdit Config
Paste these settings and save the file
{ "mcpServers": { "itu": { "command": "uvx", "args": [ "itu-mcp" ], "env": { "NINOVA_PASSWORD": "your-value", "NINOVA_LIBRARY_ID": "your-value", "NINOVA_LIBRARY_PIN": "your-value" } } } }Paste the key only into the app’s field, never into a chat or to anyone
Quit Claude and open it again
Try it
Use İTÜ MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using İTÜ MCP or shows a İTÜ MCP tool in the answer, you are connected
4 optional setting(s) (works without them)
The command above works without these. Add them only if you want to change something, following the maker’s description.
NINOVA_USERNAMEİTÜ e-posta adresi (ad.soyad@itu.edu.tr)NINOVA_MAIL_USERNAMEOptional separate ITU Mail usernameNINOVA_MAIL_PASSWORDOptional separate ITU Mail passwordNINOVA_LIBRARY_NAMEKütüphane hesabındaki ad (hesap araçları için isteğe bağlı)
Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect İTÜ MCP yet
İTÜ MCP runs on your computer, but ChatGPT can only connect servers that run on the web
What you can do instead
A · Use an app that can connect İTÜ MCP
- You need a İTÜ MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
- You need a İTÜ MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
- You need a İTÜ MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
- You need a İTÜ MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
B · Others in Other that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
- Hostinger✓ ChatGPT
- World Monitor✓ ChatGPT
- Svelte MCP✓ ChatGPT
Works with Claude Code, with some setup first
You need a İTÜ MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Let AI install it
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server İTÜ MCP for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user itu --env NINOVA_PASSWORD=your-value --env NINOVA_LIBRARY_ID=your-value --env NINOVA_LIBRARY_PIN=your-value -- uvx itu-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For NINOVA_PASSWORD, NINOVA_LIBRARY_ID, NINOVA_LIBRARY_PIN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the İTÜ MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install uv (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
uv --version- A version number such as uv … = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
uv --versionInstall once; it works for everything that needs uv
Sign up and create a İTÜ MCP key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Paste this command and press Enter
claude mcp add --scope user itu --env NINOVA_PASSWORD=your-value --env NINOVA_LIBRARY_ID=your-value --env NINOVA_LIBRARY_PIN=your-value -- uvx itu-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
Type /mcp in Claude Code
You should see İTÜ MCP listed as connected
Try it
Use İTÜ MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using İTÜ MCP or shows a İTÜ MCP tool in the answer, you are connected
4 optional setting(s) (works without them)
The command above works without these. Add them only if you want to change something, following the maker’s description.
NINOVA_USERNAMEİTÜ e-posta adresi (ad.soyad@itu.edu.tr)NINOVA_MAIL_USERNAMEOptional separate ITU Mail usernameNINOVA_MAIL_PASSWORDOptional separate ITU Mail passwordNINOVA_LIBRARY_NAMEKütüphane hesabındaki ad (hesap araçları için isteğe bağlı)
Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a İTÜ MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Let AI install it
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server İTÜ MCP for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "itu": { "command": "uvx", "args": [ "itu-mcp" ], "env": { "NINOVA_PASSWORD": "your-value", "NINOVA_LIBRARY_ID": "your-value", "NINOVA_LIBRARY_PIN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For NINOVA_PASSWORD, NINOVA_LIBRARY_ID, NINOVA_LIBRARY_PIN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the İTÜ MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install uv (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
uv --version- A version number such as uv … = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
uv --versionInstall once; it works for everything that needs uv
Sign up and create a İTÜ MCP key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Fill in your key
In the İTÜ MCP settings, NINOVA_PASSWORD, NINOVA_LIBRARY_ID, NINOVA_LIBRARY_PIN is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Open the AI chat in Cursor in Agent mode
Try it
Use İTÜ MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using İTÜ MCP or shows a İTÜ MCP tool in the answer, you are connected
4 optional setting(s) (works without them)
The command above works without these. Add them only if you want to change something, following the maker’s description.
NINOVA_USERNAMEİTÜ e-posta adresi (ad.soyad@itu.edu.tr)NINOVA_MAIL_USERNAMEOptional separate ITU Mail usernameNINOVA_MAIL_PASSWORDOptional separate ITU Mail passwordNINOVA_LIBRARY_NAMEKütüphane hesabındaki ad (hesap araçları için isteğe bağlı)
Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a İTÜ MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Let AI install it
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server İTÜ MCP for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "itu": { "type": "stdio", "command": "uvx", "args": [ "itu-mcp" ], "env": { "NINOVA_PASSWORD": "your-value", "NINOVA_LIBRARY_ID": "your-value", "NINOVA_LIBRARY_PIN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For NINOVA_PASSWORD, NINOVA_LIBRARY_ID, NINOVA_LIBRARY_PIN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the İTÜ MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install uv (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
uv --version- A version number such as uv … = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
uv --versionInstall once; it works for everything that needs uv
Sign up and create a İTÜ MCP key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Fill in your key
In the İTÜ MCP settings, NINOVA_PASSWORD, NINOVA_LIBRARY_ID, NINOVA_LIBRARY_PIN is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Open the AI chat in VS Code in Agent mode
Try it
Use İTÜ MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using İTÜ MCP or shows a İTÜ MCP tool in the answer, you are connected
4 optional setting(s) (works without them)
The command above works without these. Add them only if you want to change something, following the maker’s description.
NINOVA_USERNAMEİTÜ e-posta adresi (ad.soyad@itu.edu.tr)NINOVA_MAIL_USERNAMEOptional separate ITU Mail usernameNINOVA_MAIL_PASSWORDOptional separate ITU Mail passwordNINOVA_LIBRARY_NAMEKütüphane hesabındaki ad (hesap araçları için isteğe bağlı)
Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
For developers: Terminal commands and JSON settings
Installed on your computer
Claude Code
claude mcp add --scope user itu --env NINOVA_PASSWORD=your-value --env NINOVA_LIBRARY_ID=your-value --env NINOVA_LIBRARY_PIN=your-value -- uvx itu-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"itu": {
"command": "uvx",
"args": [
"itu-mcp"
],
"env": {
"NINOVA_PASSWORD": "your-value",
"NINOVA_LIBRARY_ID": "your-value",
"NINOVA_LIBRARY_PIN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"itu": {
"command": "uvx",
"args": [
"itu-mcp"
],
"env": {
"NINOVA_PASSWORD": "your-value",
"NINOVA_LIBRARY_ID": "your-value",
"NINOVA_LIBRARY_PIN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"itu": {
"type": "stdio",
"command": "uvx",
"args": [
"itu-mcp"
],
"env": {
"NINOVA_PASSWORD": "your-value",
"NINOVA_LIBRARY_ID": "your-value",
"NINOVA_LIBRARY_PIN": "your-value"
}
}
}
}Values you fill in
NINOVA_USERNAMEenvİTÜ e-posta adresi (ad.soyad@itu.edu.tr)NINOVA_PASSWORDsecret required envİTÜ şifresiNINOVA_MAIL_USERNAMEenvOptional separate ITU Mail usernameNINOVA_MAIL_PASSWORDsecret envOptional separate ITU Mail passwordNINOVA_LIBRARY_NAMEenvKütüphane hesabındaki ad (hesap araçları için isteğe bağlı)NINOVA_LIBRARY_IDsecret required envKütüphane üniversite numarası (hesap araçları için isteğe bağlı)NINOVA_LIBRARY_PINsecret required envAyrı kütüphane PIN'i (hesap araçları için isteğe bağlı)
Descriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
At a glance
- Downloads per weeki
- 62/wk
- Connection
- Runs on your computer
- Latest versioni
- 1.5.0
- Published to registryi
- Nov 15, 2026
- Code last changedi
- Oct 31, 2026
- Maker
- yatuk
- Packages
pypi: itu-mcp- Website
- github.com
- Registry status
- Active
Which apps can use it
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Related guides
What it can do
Runs on your computer; the tool list appears in your AI app after you install it.
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 15, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account yatuk, which owns the repo
- ✓ Pass
Still maintained
Code last changed 15 days ago
- ✓ Pass
Has a licence
Uses MIT
- – Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
- – Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
- … Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints
Published vulnerabilities (OSV.dev)
Not checked yet
Makers: ask for a re-check or report wrong info
Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
User reviews
No reviews yet
Compared with others in Otheri
- More stars than 97% of the other 19900 servers in this category
- Published to the registry more recently than 99% of the other 19900 servers in this category
- Basic checks equal to or better than 100% of the other 19900 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is İTÜ MCP safe?
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
You need to fill in: NINOVA_PASSWORD, NINOVA_LIBRARY_ID, NINOVA_LIBRARY_PIN
Does it run on my computer or in the cloud?
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
Is it still maintained?
The GitHub repo last changed 15 days ago, and the latest version (1.5.0) reached the registry today.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.
What can I use instead?
In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
Similar alternatives
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
openstatus
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Runs in the cloud✓ service owner · openstatus.dev
Oh My Posh Validator
Validate oh-my-posh configurations and segment snippets against the official schema.
Runs in the cloud✓ service owner · ohmyposh.dev
Strata
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Runs in the cloudRepo archived✓ klavis.ai
Jitsu
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
Runs in the cloud✓ service owner · jitsu.com
- World Monitor — Runs in the cloud, nothing to install · No key needed
- openstatus — Runs in the cloud, nothing to install · No key needed
- Oh My Posh Validator — Runs in the cloud, nothing to install · No key needed
- Strata — Runs in the cloud, nothing to install · No key needed
- Jitsu — Runs in the cloud, nothing to install · No key needed
README from the maker
Open the README
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
İTÜ MCP
Ninova, OBS, Portal, kütüphane ve ders arşivini yapay zeka asistanına bağla. Sonra sadece sor.
Kur · Örnekler · Sık sorulanlar · Tüm araçlar
Sesli ve tam çözünürlüklü hali: docs/demo.mp4
In English
İTÜ MCP is an unofficial, open source Model Context Protocol server for students of Istanbul Technical University (İTÜ). It runs on your own computer and lets an AI assistant such as Claude, ChatGPT, Cursor or Codex read İTÜ's systems for you: the Ninova LMS (courses, assignments, files, announcements), İTÜ Moodle and the physics, chemistry and math pool course sites (syllabi, guides, announcements), OBS (grades, schedule, registration status, transcript, graduation progress), the student Portal, the library catalog and a public archive of past course offerings.
- Ask in plain language: "what is due this week", "what will my GPA be if I get BB in everything", "which sections of MAT 210E still have seats".
- Read-only by default. The two actions that change something (uploading an assignment, saving a registration draft) ask you for confirmation first.
- Your İTÜ password stays on your machine and is sent only to İTÜ's own login page.
- Install with
pipx install itu-mcp, or add it to Claude Code as a plugin:claude plugin marketplace add yatuk/itu-mcp.
The rest of this page is in Turkish. Setup: 3 adımda kur. Full tool list: docs/advanced.md. Security model: docs/security.md. This project is not affiliated with İTÜ.
Bu ne işe yarıyor?
Ödev için Ninova'ya, not için OBS'ye, yemek için Portal'a girmek yerine asistanına yazıyorsun, o da gerçek veriyi çekip cevaplıyor.
İTÜ MCP bilgisayarında çalışan küçük bir programdır. Claude, Cursor veya Codex gibi bir asistana İTÜ sistemlerini okuma yeteneği kazandırır. Kod yazmayı bilmen gerekmez, kurup soru sorman yeterli.
| Sen yazarsın | O bakar |
|---|---|
| "Bu hafta hangi ödevlerim var?" | Ninova |
| "Vize notlarım açıklandı mı?" | OBS |
| "Bugün yemekte ne var?" | Portal |
| "Bu dersi geçen yıl kim verdi, kaç kişi AA aldı?" | Ders arşivi |
| "Kütüphanede bu kitap var mı?" | Kütüphane kataloğu |
| "Ödevim için uyku ve akademik başarı üzerine makale bul" | Makale indeksi, kütüphane veritabanları |
| "Okunmamış maillerimi özetle" | İTÜ Mail |
| "FIZ 102E izlencesini ve duyurularını oku" | Moodle ve havuz siteleri |
| "Bu şubede yer açılınca haberim olsun" | Kontenjan takibi |
| "Ders programımı telefonumun takvimine ekle" | Takvim dosyası (.ics) |
Şifren bilgisayarından çıkmaz. Program yalnızca İTÜ'nün kendi sunucularıyla konuşur.
İstanbul Teknik Üniversitesi ile resmi bir bağlantısı yoktur.
3 adımda kur
Python 3.11 veya üstü gerekir. Yüklü değilse python.org adresinden kurabilirsin.
1. Programı kur
pipx install "itu-mcp[keyring]"pipx yoksa pip install --user "itu-mcp[keyring]" da olur.
2. Giriş bilgilerini kaydet ve asistanına bağla
itu-mcp setupitu-mcp connectitu-mcp setup İTÜ e-postanı ve şifreni sorar. Şifre yazarken ekranda görünmez ve hiçbir dosyaya yazılmaz, işletim sisteminin anahtar zincirine kaydedilir (Windows Kimlik Bilgileri Yöneticisi, macOS Anahtar Zinciri, Linux'ta GNOME Keyring ya da KWallet).
itu-mcp connect sunucuyu Claude Desktop, Claude Code ve Cursor ayarlarına şifresiz olarak ekler. Diğer ayarlarına dokunmaz, dosyanın yedeğini alır. Ne yapacağını önce görmek istersen itu-mcp connect --dry-run yaz. Tek bir asistan için: itu-mcp connect claude-desktop (ya da claude-code, cursor).
Anahtar zinciri istemiyorum ya da Codex kullanıyorum
Şifreyi asistanın ayarına elle de yazabilirsin.
Claude Code
claude mcp add itu itu-mcp -e NINOVA_USERNAME=ad.soyad@itu.edu.tr -e NINOVA_PASSWORD=sifrenCodex CLI
codex mcp add itu --env NINOVA_USERNAME=ad.soyad@itu.edu.tr --env NINOVA_PASSWORD=sifren -- itu-mcpClaude Desktop ve Cursor için hazır ayar dosyaları examples/ klasöründe. Adım adım anlatım: docs/installation.md.
3. Sor
Asistanı yeniden başlat ve yaz:
Ninova'daki derslerimi listeleBir liste geldiyse kurulum tamam.
Çalışmadı, ne yapmalıyım?
Önce şunu çalıştır:
itu-mcp doctorHer satır OK, UYARI ya da HATA ile başlar ve OK olmayan satırın altında çözümü yazar. Girişi de denemesi için itu-mcp doctor --online yaz.
- Giriş hata veriyorsa kullanıcı adını tam e-posta olarak yazdığından emin ol (
ad.soyad@itu.edu.tr, yalnızcaad.soyaddeğil). - Komut bulunamıyorsa terminali kapatıp yeniden aç.
pipxkurulumdan sonra yeni bir terminal ister. - Asistan aracı görmüyorsa asistanı tamamen kapatıp açmayı dene.
- Hâlâ olmuyorsa bir sorun kaydı aç, ekran çıktısını ekle. Şifreni yazma.
Şifre vermek istemiyor musun? Ders programı, final tarihleri, not dağılımları, ders arşivi, mekik saatleri ve kütüphane kataloğu gibi herkese açık bilgiler şifresiz de çalışır.
itu-mcp setupadımını atlayıp yalnızcaitu-mcp connectçalıştırman yeterli.
Neler sorabilirsin?
Aşağıdakiler Claude Code'a yazılmış örnek sorular. Sen kendi cümlelerinle sorabilirsin, hangi aracın çağrılacağını asistan seçer. Çıktılar örnektir, sende kendi verin görünür.
Ödev takibi
> Bu hafta hangi ödevlerimin teslimi var?● itu · get_upcoming_deadlines
Bu hafta 2 teslimin var:
BLG 223E Ödev 3 Perşembe 23:59, 2 gün kaldı Henüz yüklenmemiş
MAT 210E Proje raporu Pazar 23:59, 5 gün kaldı Yüklendi
Dersi kim verdi, nasıl geçti?
> BLG 223E geçen güz nasıl geçmiş?● itu · archive_grade_distribution
2025-2026 Güz, 176 öğrenci:
AA 9 CC+ 19 BA+ 12 CC 21 BB+ 18 FF 38
En kalabalık not FF (38 kişi). AA alan 9 kişi var.
Kayıt haftası
> 12469, 12554 ve 12583 CRN'leriçakışıyor mu?
● itu · check_course_conflicts
1 çakışma buldum:
Salı 08:30-10:29 BLG 223E ile BLG 345E üst üste
12583 (BLG 422E) sorunsuz. BLG 345E için başka şube arayayım mı?
Ön şart kontrolü
> BLG 335E'yi bu dönem alabilir miyim?● itu · explain_course_eligibility
Henüz alamazsın.
Gereken: BLG 223E (en az DD) Durumun: BLG 223E bu dönem kayıtlı, notu açıklanmamış
BLG 223E'yi geçersen gelecek dönem açılıyor.
Günlük işler
> Bugün yemekte ne var, mekik kaçta?● itu · get_cafeteria_menu ● itu · get_shuttle_schedule
Öğle yemeği: Mercimek çorbası, tavuk sote, pirinç pilavı, sütlaç
Ayazağa'dan sonraki mekik 13:30.
Not ve ortalama
> Bu dönem hepsinden BB alırsamortalamam kaç olur?
● itu · obs_simulate_cumulative_gpa
Şu anki GANO: 2.08 Dönem tahmini: 3.00 Dönem sonu GANO: 2.74
Tekrar aldığın 2 ders eski notun yerine sayıldı, 1 ders yeni eklendi.
Bu bir tahmin, resmi ortalama OBS'de açıklanır.
Daha fazla fikir:
- "EEF 211E sınıf dosyalarındaki son PDF'i özetle."
- "Danışmanım kim, staj durumum ne?"
- "Transkriptimi indir."
- "BBB binasında şu an boş derslik var mı?"
- "BLG 223E'yi geçersem hangi dersler açılır?"
- "Mezuniyetime kaç ders kaldı, gelecek dönem hangilerini almalıyım?"
- "Kütüphanede Introduction to Algorithms var mı?"
- "Son okunmamış maillerimi listele, ekindeki PDF'i özetle."
Asistanın / menüsünde hazır akışlar da var: weekly_briefing (haftalık özet), plan_next_term (gelecek dönem planı), registration_week (kayıt haftası kontrolü), check_course_eligibility, research_course ve gpa_scenario.
Sık sorulanlar
Şifrem nereye gidiyor?
Hiçbir yere. Program senin bilgisayarında çalışır ve şifreni yalnızca İTÜ'nün kendi giriş sayfasına gönderir, tıpkı tarayıcının yaptığı gibi. Arada bizim ya da başkasının bir sunucusu yoktur. Kod açık, istersen kendin bakabilirsin.
Bu resmi bir İTÜ uygulaması mı?
Hayır. Öğrenciler tarafından yazılmış açık kaynak bir projedir, İTÜ ile resmi bağlantısı yoktur. Yalnızca kendi hesabınla kullan.
Hesabımda bir şeyi değiştirebilir mi?
Neredeyse her şey yalnızca okur. İki istisna var ve ikisi de senin açık onayın olmadan çalışmaz:
- Ödev yükleme. Önce neyi nereye yükleyeceğini gösterir, sen onaylayınca yükler.
- Kayıt taslağı kaydetme. Varsayılan olarak kapalıdır. Açsan bile taslaktan ders silinecekse durur ve sana sorar.
İkisinde de, asistanın destekliyorsa, program göndermeden hemen önce sana doğrudan bir onay penceresi açar: hangi dosya, hangi ödev, hangi CRN'ler yazılacak, hangileri taslaktan çıkacak. Asistanın kendi kendine "onaylıyorum" demesi bu pencereyi atlatamaz. Onaylamazsan hiçbir şey gönderilmez.
Ders kaydı yapmaz, ders bırakmaz, mail göndermez.
Verdiği cevaba güvenebilir miyim?
Veriyi doğrudan İTÜ sistemlerinden çeker, uydurmaz. Yine de OBS bazı bilgileri hesaba göre farklı döndürebiliyor. Bir veri eksikse araç bunu açıkça söyler. Kayıt, mezuniyet ve not gibi önemli kararlarda son sözü her zaman OBS'nin kendi sayfası söyler.
Hangi asistanlarla çalışıyor?
MCP destekleyen her istemciyle: Claude Code, Claude Desktop, Cursor, Codex ve benzerleri. ChatGPT ya da Claude.ai gibi web arayüzleri için uzak sunucu kurulumu gerekir, anlatımı docs/advanced.md içinde.
Yer açılınca haber verebilir mi?
Kısmen. Dolu bir şubenin CRN'ini izleme listesine ekleyebilirsin (watch_course_sections), sonra "izlediğim şubelerde yer açıldı mı" diye sorduğunda son kontrolden bu yana ne değiştiğini söyler. Giriş gerektirmez.
Ama program arka planda çalışmaz ve kendiliğinden bildirim göndermez. Kontenjan yalnızca sen sorduğunda okunur. Düzenli takip istiyorsan asistanında birkaç dakikada bir bu soruyu soran zamanlanmış bir görev kurman gerekir.
Araç sayısı çok fazla, azaltabilir miyim?
Evet. Araçlar gruplara ayrılmış durumda