Valoon para Claude
Español

Documentación del conector

Valoon para Claude

Valoon para Claude permite a Claude leer y actualizar tus proyectos de Valoon: tickets, informes diarios, archivos, fotos de obra y registros de tiempo. Funciona como servidor MCP oficial operado por Valoon GmbH.

https://dev.mcp.valoon.crucerlabs.com/mcp

Selecciona la URL y pégala en Claude al añadir un conector personalizado.

En esta página

Descripción general

El conector da a Claude acceso a tus proyectos de Valoon a través del Model Context Protocol. Claude solo ve lo que puede ver tu propia cuenta de Valoon, y cada cambio que hace se realiza con tu cuenta.

Los usos típicos son resumir lo que pasó en una obra esta semana, convertir notas de obra en tickets, redactar el informe diario a partir de fotos y notas de obra, y revisar las horas registradas antes de la nómina.

Antes de empezar

  • Una cuenta de Valoon con acceso a los proyectos con los que quieres trabajar.
  • Una API key de Valoon. Encontrarás su Client ID y su Secret en Valoon → Ajustes → API keys.
  • Un plan de Claude que admita conectores personalizados.
  • En los planes Team y Enterprise, puede que un propietario tenga que permitir los conectores personalizados en Configuración de la organización → Conectores.

Conectar Valoon con Claude

Claude.ai y Claude Desktop

  1. Abre Configuración → Conectores y elige Añadir conector personalizado.
  2. Escribe Valoon como nombre y pega la URL del conector: https://dev.mcp.valoon.crucerlabs.com/mcp
  3. Selecciona Conectar. Se abre la página de autorización de Valoon.
  4. Introduce el Client ID y el Secret de tu API key de Valoon y selecciona Autorizar acceso.
  5. De vuelta en Claude, activa desde el menú de herramientas las herramientas de Valoon que quieras usar en la conversación.

Claude Code

Añade el servidor desde tu terminal:

claude mcp add --transport http valoon https://dev.mcp.valoon.crucerlabs.com/mcp

Después ejecuta /mcp dentro de Claude Code, selecciona Valoon y autentícate. Tu navegador abre la misma página de autorización. Una vez que hayas autorizado el acceso, Valoon aparece como connected.

Permisos y datos

Cada herramienta lleva una de tres etiquetas, y el servidor se la comunica a Claude con cada herramienta, para que Claude distinga las lecturas de los cambios. Según tu configuración de Claude, Claude te pide confirmación antes de ejecutar una herramienta.

Etiqueta Qué hace la herramienta Ejemplo
Lectura Lee datos. Nada cambia en Valoon. list_tickets
Escritura Crea, actualiza o mueve datos en Valoon. create_report
Envía mensajes Inicia una conversación de Valoon con los participantes de un ticket. send_ticket

Los mensajes llegan a personas reales

Las herramientas con la etiqueta Envía mensajes escriben en tu nombre a los participantes del ticket, y un mensaje enviado no se puede deshacer. Revisa qué tickets quiere enviar Claude antes de confirmar. Crear o actualizar proyectos y tickets también envía las mismas notificaciones que la app de Valoon.

Inicias sesión con tu API key de Valoon. El Client ID y el Secret se verifican contra la API de Valoon y nunca se almacenan en el servidor. Claude recibe un token de acceso válido durante una hora, que se renueva con un token de actualización válido durante 30 días y que se sustituye en cada uso.

Claude solo recibe los resultados de las herramientas que llama. Para la operación del servicio, el servidor registra de cada llamada el nombre de la herramienta, tu Client ID, la aplicación de Claude, la duración y el estado del resultado, pero no sus argumentos ni su respuesta.

Ejemplos de prompts

  • “Resume todos los defectos abiertos en Schillerstraße 12 y agrúpalos por gremio.”
  • “Crea tickets a partir de estas notas de obra y añade al equipo de Hoffmann Elektro como participantes.”
  • “Redacta el informe diario de hoy para JACTESP a partir de las fotos subidas esta mañana.”
  • “¿Qué miembros de la cuadrilla registraron más de 10 horas en algún día de la semana pasada?”

Una rutina que funciona bien: pide a Claude cada viernes un resumen de obra por proyecto. Lee los tickets e informes de la semana y entrega al jefe de proyecto un estado de una página.

Herramientas

Las herramientas están agrupadas por área. Los grupos están contraídos para que la lista sea breve; abre uno para ver sus herramientas. Los nombres y las descripciones de las herramientas están en inglés, y son los nombres que Claude usa al llamar a una herramienta.

LecturaEscrituraEnvía mensajes
Básico1 herramientaTu cuenta con sesión iniciada
  • Who Am Iwhoami

    Returns the currently authenticated user. Use this to identify who is making the request.

    Lectura
Proyectos7 herramientasProyectos, su historial y estadísticas
  • Create Projectcreate_project

    Create a new Project.

    Escritura
  • Get All Project Statisticsget_all_project_statistics

    Get statistics across all projects.

    Lectura
  • Get Projectget_project

    Get a Project by id.

    Lectura
  • Get Project Historyget_project_history

    Get the full event history of a project.

    Lectura
  • Get Project Statisticsget_project_statistics

    Get statistics for a specific project.

    Lectura
  • List Projectslist_projects

    List Projects.

    Lectura
  • Update Projectupdate_project

    Update an existing Project by id.

    Escritura
Tickets23 herramientasTickets, etiquetas, ámbitos y ajustes de flujo
  • Add Ticket Labelsadd_ticket_labels

    Add labels to a ticket.

    Escritura
  • Add Ticket Participantsadd_ticket_participants

    Add users to a ticket as participants.

    Escritura
  • Create Labelcreate_label

    Create a new Label.

    Escritura
  • Create Scopecreate_scope

    Create a new Scope.

    Escritura
  • Create Ticketcreate_ticket

    Create a new Ticket.

    Escritura
  • Dispatch Ticketdispatch_ticket

    Start the ticket conversation with every participant of one ticket.

    Envía mensajes
  • Duplicate Ticketduplicate_ticket

    Copy a ticket, optionally into another project or under a new title.

    Escritura
  • Get Labelget_label

    Get a Label by id.

    Lectura
  • Get Scopeget_scope

    Get a Scope by id.

    Lectura
  • Get Ticketget_ticket

    Get a Ticket by id.

    Lectura
  • Get Ticket Historyget_ticket_history

    Get the full event history of a ticket.

    Lectura
  • Get Ticket Flow Settingget_ticketflowsetting

    Get a TicketFlowSetting by id.

    Lectura
  • List Labelslist_labels

    List Labels.

    Lectura
  • List Scopeslist_scopes

    List Scopes.

    Lectura
  • List Ticketslist_tickets

    List Tickets.

    Lectura
  • Move Ticketmove_ticket

    Move a ticket to a different project.

    Escritura
  • Remove Ticket Labelsremove_ticket_labels

    Remove labels from a ticket.

    Escritura
  • Remove Ticket Participantsremove_ticket_participants

    Remove users from a ticket's participants.

    Escritura
  • Send Ticketsend_ticket

    Start the ticket-list conversation with every participant of the listed tickets.

    Envía mensajes
  • Update Labelupdate_label

    Update an existing Label by id.

    Escritura
  • Update Scopeupdate_scope

    Update an existing Scope by id.

    Escritura
  • Update Ticketupdate_ticket

    Update an existing Ticket by id.

    Escritura
  • Update Ticket Flow Settingupdate_ticketflowsetting

    Update an existing TicketFlowSetting by id.

    Escritura
Informes14 herramientasInformes, plantillas y exportaciones en PDF
  • Create Reportcreate_report

    Create a new report from a template, either in a project (projectId) or linked to a ticket (ticketId, which places it in the ticket's project). Pass exactly one of the two.

    Escritura
  • Duplicate Reportduplicate_report

    Duplicate an existing report. Returns the new copy.

    Escritura
  • Get Reportget_report

    Get a report by id, including its form data and state.

    Lectura
  • Get Report PDFget_report_pdf

    Generate and download the PDF of a report.

    Lectura
  • Get Report Templateget_report_template

    Get a report template by id, optionally a specific version. Includes the form structure.

    Lectura
  • Get Reports by Ticketget_reports_by_ticket

    List all reports linked to a specific ticket.

    Lectura
  • List Export Templateslist_exporttemplates

    List ExportTemplates.

    Lectura
  • List Report Labelslist_report_labels

    List the tenant's report labels (such as Open, In Progress, Approved and Invoiced), ordered by their sort order.

    Lectura
  • List Report Templateslist_report_templates

    List all report templates of the tenant.

    Lectura
  • List Reportslist_reports

    List reports, filtered and sorted on the server; newest report date first by default.

    Lectura
  • Move Reportmove_report

    Move a report to another project.

    Escritura
  • Set Report Labelset_report_label

    Set a report's label, or clear it with labelId none. Works in every report state, finalized reports included: the label is workflow metadata, not report content.

    Escritura
  • Set Report Ticketset_report_ticket

    Link a report to a ticket, or unlink it from its ticket with ticketId none.

    Escritura
  • Update Reportupdate_report

    Update a report's title, date, state or form data.

    Escritura
Archivos y multimedia21 herramientasCarpetas, archivos, fotos y escaneos
  • Copy Filescopy_files

    Copy files and/or folders into a target folder.

    Escritura
  • Create Foldercreate_folder

    Create a new Folder.

    Escritura
  • Create Scan Typecreate_scantype

    Create a new ScanType.

    Escritura
  • Get Attachmentget_attachment

    Get a Attachment by id.

    Lectura
  • Get Fileget_file

    Get a File by id.

    Lectura
  • Get Folderget_folder

    Get a Folder by id.

    Lectura
  • Get Folder Childrenget_folder_children

    List the contents (subfolders and files) of a folder.

    Lectura
  • Get Folder Parentsget_folder_parents

    Get the parent folders (ancestor chain) of a folder.

    Lectura
  • Get Mediaget_media

    Download the media (photo, document) attached to an entity, returned inline so images are directly visible.

    Lectura
  • Get Scanget_scan

    Get a Scan by id.

    Lectura
  • Get Scan Typeget_scantype

    Get a ScanType by id.

    Lectura
  • List Attachmentslist_attachments

    List Attachments.

    Lectura
  • List Fileslist_files

    List Files.

    Lectura
  • List Folderslist_folders

    List Folders.

    Lectura
  • List Photo Gallerylist_photogallery

    List PhotoGallery.

    Lectura
  • List Scanslist_scans

    List Scans.

    Lectura
  • List Scan Typeslist_scantypes

    List ScanTypes.

    Lectura
  • Move Filesmove_files

    Move files and/or folders into a target folder.

    Escritura
  • Update Folderupdate_folder

    Update an existing Folder by id.

    Escritura
  • Update Scanupdate_scan

    Update an existing Scan by id.

    Escritura
  • Update Scan Typeupdate_scantype

    Update an existing ScanType by id.

    Escritura
Registro de tiempo8 herramientasRegistros de tiempo y tipos de tiempo
  • Create Time Entrycreate_timeentry

    Create a new TimeEntry.

    Escritura
  • Get Time Entryget_timeentry

    Get a TimeEntry by id.

    Lectura
  • Get Time Entry Historyget_timeentry_history

    Get the full event history of a time entry.

    Lectura
  • Get Time Typeget_timetype

    Get a TimeType by id.

    Lectura
  • List Time Entrieslist_timeentries

    List TimeEntries.

    Lectura
  • List Time Typeslist_timetypes

    List TimeTypes.

    Lectura
  • Update Time Entryupdate_timeentry

    Update an existing TimeEntry by id.

    Escritura
  • Update Time Typeupdate_timetype

    Update an existing TimeType by id.

    Escritura
Administración10 herramientasUsuarios, grupos y ajustes de la organización
  • Create Groupcreate_group

    Create a new Group.

    Escritura
  • Get Groupget_group

    Get a Group by id.

    Lectura
  • Get Tenantget_tenant

    Get a Tenant by id.

    Lectura
  • Get Userget_user

    Get a User by id.

    Lectura
  • List Groupslist_groups

    List Groups.

    Lectura
  • List Tenantslist_tenants

    List Tenants.

    Lectura
  • List Userslist_users

    List Users.

    Lectura
  • Update Groupupdate_group

    Update an existing Group by id.

    Escritura
  • Update Tenantupdate_tenant

    Update an existing Tenant by id.

    Escritura
  • Update Userupdate_user

    Update an existing User by id.

    Escritura

Solución de problemas

La página de autorización se cierra sin conectar

Puede que tu navegador bloquee la ventana emergente. Permite las ventanas emergentes para claude.ai y vuelve a seleccionar Conectar.

“No pudimos verificar tus credenciales”

El Client ID o el Secret son incorrectos, o la API key ya no existe. Vuelve a copiar ambos desde Valoon → Ajustes → API keys e inténtalo de nuevo.

Claude dice que un proyecto no existe

Claude solo ve los proyectos a los que tiene acceso tu cuenta de Valoon. Pide a Claude que llame a list_projects para verlos. Si falta el proyecto, pide a un propietario del proyecto que te añada.

Una herramienta de escritura devuelve “forbidden”

Tu rol en Valoon no permite esa acción en el proyecto. Pide a un propietario del proyecto que cambie tu rol, o haz la versión de solo lectura de la petición.

Privacidad y soporte

Para desconectar, elimina el conector en la configuración de Claude. Para revocar el acceso por completo, elimina la API key en Valoon, en Valoon → Ajustes → API keys; a partir de entonces, cualquier llamada hecha con ella falla.

Lee la política de privacidad y los términos. Si necesitas ayuda, escribe a support@valoon.chat e indica la hora de la petición fallida.