Ir al contenido

Wikis de proyecto

La wiki de un proyecto: listar sus páginas, leer una, crear, actualizar y borrar una, y subir un archivo adjunto que una página puede referenciar. Las wikis de grupo son acciones de Grupos, que se sirven a partir de Premium.

  • “Lista las páginas de la wiki del proyecto 42”
  • “Muestra la página Home de la wiki”
  • “Crea una página de la wiki con la lista de comprobación de la release”
  • Dinámica, la superficie predeterminada: llama a gitlab_execute_action con action igual al ID de la acción, como wiki.create, y sus parámetros en params. gitlab_find_action encuentra un ID a partir de una descripción de la tarea.
  • Meta (GITLAB_MCP_TOOL_SURFACE=meta): llama a gitlab_wiki con action igual al nombre de la acción, como create, y sus parámetros en params.
  • Individual (GITLAB_MCP_TOOL_SURFACE=individual): llama a la herramienta propia de la acción, como gitlab_wiki_create, pasándole directamente sus parámetros.

Todos los niveles sirven el grupo completo, tanto en instancias autogestionadas como en GitLab.com.

Acciones de solo lectura: 2 de 6, las que conserva un despliegue en modo de solo lectura.

La descripción de cada acción, y la de cada uno de sus parámetros, es el texto que sirve el servidor para ella en la superficie predeterminada, citado tal cual; por eso está en inglés. Una acción destructiva solo se ejecuta una vez confirmada, salvo que GITLAB_MCP_YOLO_MODE (o AUTOPILOT) se salte ese paso: la superficie dinámica necesita confirm: true en gitlab_execute_action, y las otras dos aceptan un parámetro confirm o la pregunta del cliente (Acciones destructivas).

AcciónIndividual
wiki.creategitlab_wiki_create
wiki.deletegitlab_wiki_delete
wiki.getgitlab_wiki_get
wiki.listgitlab_wiki_list
wiki.updategitlab_wiki_update
wiki.upload_attachmentgitlab_wiki_upload_attachment

Create a new wiki page. Returns: the created page with title, slug, format, content, and encoding. See also: wiki.get, wiki.update, wiki.list.

  • Meta-herramienta: gitlab_wiki, acción create
  • Herramienta individual: gitlab_wiki_create
  • Nivel: Free
  • Comportamiento: escribe, no idempotente
ParámetroTipoRequeridoDescripción
contentstringsíContent of the wiki page (Markdown, RDoc, AsciiDoc, or Org)
project_idstring/integersíProject ID or URL-encoded path
titlestringsíTitle of the wiki page
formatstring (markdown, rdoc, asciidoc, org)noContent format: markdown (default), rdoc, asciidoc, or org

Delete a wiki page permanently. Returns: a success confirmation for the removed page. See also: wiki.get, wiki.list.

  • Meta-herramienta: gitlab_wiki, acción delete
  • Herramienta individual: gitlab_wiki_delete
  • Nivel: Free
  • Comportamiento: escribe, destructiva (necesita confirmación), idempotente
ParámetroTipoRequeridoDescripción
project_idstring/integersíProject ID or URL-encoded path
slugstringsíURL-encoded slug of the wiki page to delete

Get a single wiki page by slug. Returns: the page title, slug, format, content, and encoding. See also: wiki.list, wiki.update, wiki.delete.

  • Meta-herramienta: gitlab_wiki, acción get
  • Herramienta individual: gitlab_wiki_get
  • Nivel: Free
  • Comportamiento: solo lectura, idempotente
ParámetroTipoRequeridoDescripción
project_idstring/integersíProject ID or URL-encoded path
slugstringsíURL-encoded slug of the wiki page (e.g. ‘my-page’)
render_htmlbooleannoReturn HTML-rendered content instead of raw format
versionstringnoWiki page version SHA to retrieve a specific revision

List a project’s wiki pages. Returns: each page’s title, slug, and format (plus content when with_content is set), with hints to read or create pages. See also: wiki.get, wiki.create.

  • Meta-herramienta: gitlab_wiki, acción list
  • Herramienta individual: gitlab_wiki_list
  • Nivel: Free
  • Comportamiento: solo lectura, idempotente
ParámetroTipoRequeridoDescripción
project_idstring/integersíProject ID or URL-encoded path
with_contentbooleannoInclude page content in the response

Update an existing wiki page by slug. Returns: the updated page with title, slug, format, content, and encoding. See also: wiki.get, wiki.delete, wiki.list.

  • Meta-herramienta: gitlab_wiki, acción update
  • Herramienta individual: gitlab_wiki_update
  • Nivel: Free
  • Comportamiento: escribe, idempotente
ParámetroTipoRequeridoDescripción
project_idstring/integersíProject ID or URL-encoded path
slugstringsíURL-encoded slug of the wiki page to update
contentstringnoNew content for the wiki page
formatstring (markdown, rdoc, asciidoc, org)noContent format: markdown, rdoc, asciidoc, or org
titlestringnoNew title for the wiki page

Upload an attachment to the project wiki repository. Returns: the attachment file name, file path, branch, URL, and ready-to-paste Markdown link. See also: wiki.get, wiki.update.

  • Meta-herramienta: gitlab_wiki, acción upload_attachment
  • Herramienta individual: gitlab_wiki_upload_attachment
  • Nivel: Free
  • Comportamiento: escribe, no idempotente
ParámetroTipoRequeridoDescripción
filenamestringsíName of the file to upload (e.g. diagram.png)
project_idstring/integersíProject ID or URL-encoded path
branchstringnoBranch to upload the attachment to
content_base64stringnoBase64-encoded file content. Provide either content_base64 or file_path
file_pathstringnoAbsolute path to a local file. Provide either file_path or content_base64