MCP-palvelin

Yhdistä tekoälyasiakkaat, kuten Claude Code tai Codex, projektiin sen MCP-palvelimen kautta.

Jokaisella projektilla on MCP-palvelin, joten tekoälyasiakkaat, kuten Claude Code, Codex, Cursor, VS Code tai Gemini CLI, voivat työskennellä sen parissa: lukea ja muokata sen tiedostoja, kääntää sen, lukea LaTeX-lokin, ladata PDF:n ja vastata kommentteihin.

Tämän ominaisuuden on kehittänyt ayaka-notes/ayakaleaf-pro. Se on otettu käyttöön versiosta v6.3.1 alkaen.

​

Määrittäminen

MCP-palvelin tulee Git-integraation mukana: ota git-bridge käyttöön, niin myös MCP-palvelin on käytettävissä. Muuta määritettävää ei ole.

​

Tekoälyasiakkaan yhdistäminen

1. Luo Account Settings -kohdassa Git-todennustunnus. Samaa tunnusta käytetään sekä MCP-palvelimelle että Gitille.
2. Avaa editorissa Integrations ja napsauta MCP server. Siinä näkyy projektin MCP-palvelimen osoite https://<your-overleaf>/project/<project_id>/mcp sekä ohjeet sen lisäämiseksi kuhunkin tekoälyasiakkaaseen: kopioi komento ja korvaa <token> omalla tunnuksellasi.

Tunnus lähetetään HTTP-otsakkeena Authorization: Bearer <token>. Esimerkiksi Claude Coden komento on:

claude mcp add --transport http overleaf \
  https://<your-overleaf>/project/<project_id>/mcp \
  --header "Authorization: Bearer <token>"

​

Käyttö

Kun yhteys on muodostettu, pyydä tekoälyasiakasta tavallisin sanoin. Esimerkiksi:

Pyydät	Tekoälyasiakas käyttää
Korjaa johdannon kirjoitusvirheet.	read_file, edit_file: muokkaukset näkyvät reaaliaikaisesti editorissa
Käännä projekti ja korjaa LaTeX-virheet.	compile, get_compile_log, edit_file
Vastaa avoimiin kommentteihin ja ratkaise ne sitten.	list_comments, reply_to_comment, resolve_comment
Vaihda XeLaTeXiin ja lataa PDF.	update_settings, compile, get_output_file_link

​

Työkalut

Ryhmä	Työkalut
Projekti	get_clone_info, get_settings, update_settings, list_versions
Tiedostot	list_files, read_file, edit_file, write_file, delete_file
Kääntäminen	compile, get_compile_log, get_output_file_link, word_count
Kommentit	list_comments, reply_to_comment, resolve_comment, reopen_comment

Työkaluilla edit_file ja write_file tehdyt muokkaukset näkyvät reaaliaikaisesti editorissa ja yhdistyvät yhteistyökumppaneiden muokkauksiin. Kun kyse on useista tiedostoista kerralla, binaaritiedostoista tai uudelleennimeämisistä, tekoälyasiakas voi myös kloonata projektin Gitillä ja pushata muutokset.

​

Käyttöoikeudet

MCP-palvelin noudattaa projektin jakoasetuksia samoin kuin Git:

• Kaikki, jotka voivat tarkastella projektia, voivat lukea sitä, kääntää sen ja ladata sen tulosteet.
• Vain omistaja ja muokkaajat voivat muuttaa sen tiedostoja ja asetuksia.
• Arvioijat voivat lisäksi vastata kommentteihin sekä ratkaista tai avata uudelleen aloittamansa kommentit.
• Linkin kautta liittyneet katselijat eivät näe kommentteja, kuten ei editorissakaan.

​

Q&A

En näe editorissa kohtaa Integrations tai MCP server

Vastaus: MCP-palvelimella ei ole omaa ympäristömuuttujaa. Se otetaan käyttöön asetuksella GIT_BRIDGE_ENABLED=true tiedostossa config/overleaf.rc, katso Git-integraatio. Kun olet muuttanut asetusta, aja bin/up -d. Ilman git-bridgeä editori ei näytä Integrations-välilehteä vasemmassa palkissaan.