> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integraciones MAIP

> Conecte sus agentes de IA a las herramientas y plataformas que su equipo ya utiliza.

# Integraciones MAIP

El Protocolo de Identidad de Agente de Máquina (MAIP) incluye integraciones que incorporan la identidad del agente, los recibos y la puntuación de confianza en sus flujos de trabajo existentes. La evidencia local, el envío de recibos alojados y la verificación de firmas son operaciones separadas. Configure y pruebe la integración que utiliza; la instalación por sí sola no crea una pista de auditoría completa.

> [!NOTE]
>
> **Requisitos previos:** Necesita una cuenta de Truthlocks con una clave API y al menos un agente registrado. Consulte la [guía de identidad de la máquina](https://docs.truthlocks.com/es/guides/machine-identity.md) para registrar su primer agente.

> [!TIP]
>
> Explore las integraciones disponibles en el [Centro de integraciones](https://truthlocks.com/resources/integrations). Los enlaces están agrupados por SDK, marco de IA, editor y herramienta de colaboración.

## Herramientas para desarrolladores

### Extensión de VS Code

Un panel lateral para explorar recibos, generar recibos desde su editor y ver datos de confianza. Instálelo desde el [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=truthlocks.maip-vscode).

**Qué hace:**

* Navegar y buscar recibos MAIP desde la barra lateral
* Generar recibos de cambios de código directamente desde el editor
* Ver puntuaciones de confianza del agente y cadenas de recibos

**Instalación:**

1. Abra VS Code y vaya a la vista de Extensiones (`Ctrl+Shift+X` / `Cmd+Shift+X`).
2. Busque "Truthlocks MAIP".
3. Haga clic en **Instalar**.

Alternativamente, instale desde la línea de comandos:

```bash theme={null}
code --install-extension truthlocks.maip-vscode
```

Después de la instalación, abra el panel lateral de MAIP e ingrese su clave API y ID de agente para conectarse.

### Plugin de JetBrains

Integración de MAIP para IntelliJ, PyCharm y WebStorm con las mismas capacidades de navegación y generación de recibos que la extensión de VS Code.

### Complemento de Neovim

Instale el complemento `truthlocks/maip.nvim` lanzado, con curl disponible en su PATH:

```lua theme={null}
-- lazy.nvim
{ "truthlocks/maip.nvim", tag = "v1.1.0", main = "maip",
  opts = {
    api_url = "https://sandbox-api.truthlocks.com/v1",
    api_key = vim.env.MAIP_API_KEY or "",
    agent_id = vim.env.MAIP_AGENT_ID or "",
    auto_receipt_on_commit = false,
    telescope = false,
  } }
```

Use `:MAIPListAgents`, `:MAIPCreateReceipt`, `:MAIPListReceipts`,
`:MAIPVerifyReceipt`, `:MAIPShowTrust` y `:MAIPDashboard`. Los metadatos del recibo son
no es una firma verificada. Los recibos de confirmación automáticos son opcionales y observan los compatibles
eventos de confirmación completados; no hay opción `auto_receipt` para guardar en esta versión.
Consulte el [README versionado](https://github.com/truthlocks/maip.nvim) para Telescope
configuración y los límites actuales de las pruebas interactivas.

### Servidor MCP

Instale el ejecutable en la máquina que ejecuta su host MCP:

```sh theme={null}
npm install --global @truthlocks/maip-mcp-server@1.2.4
```

```json theme={null}
{
  "mcpServers": {
    "truthlocks": {
      "command": "maip-mcp-server",
      "env": {
        "MAIP_API_URL": "https://sandbox-api.truthlocks.com/v1",
        "MAIP_API_KEY": "REPLACE_WITH_WORKSPACE_TEST_KEY",
        "MAIP_TIMEOUT_MS": "30000",
        "MAIP_MAX_RETRIES": "3"
      }
    }
  }
}
```

Suministre las credenciales a través de la configuración segura del host. Utilice una clave y un agente
del mismo entorno. Pida al anfitrión que enumere las herramientas disponibles, luego use
`maip_list_agents`, `maip_list_receipts` y `maip_verify_receipt`. Una firma positiva
el resultado requiere `valid: true`, `signature_verified: true` y `verdict: "VALID"`.
La verificación de transparencia es un resultado separado. Las escrituras no se reintentan automáticamente.

## Colaboración en equipo

Las integraciones de Slack, Linear y Notion requieren su propia aplicación/espacio de trabajo real
credenciales además de la autenticación de Truthlocks. Su proceso completo de proveedor a recibo
la aceptación aún está pendiente. No trate la disponibilidad de la fuente, las pruebas locales o un
Clave API de Truthlocks como prueba de que un espacio de trabajo externo está conectado.

Revise el README del paquete fuente para conocer los permisos y la configuración del proveedor:
[Slack](https://github.com/truthlocks/truthlock/tree/main/packages/maip-slack),
[Linear](https://github.com/truthlocks/truthlock/tree/main/packages/maip-linear),
[Notion](https://github.com/truthlocks/truthlock/tree/main/packages/maip-notion).
Utilice un espacio de trabajo de prueba dedicado antes de habilitar el procesamiento de eventos reales.

### Configuración y validación de Slack

Slack es una instalación de origen, no un paquete npm publicado de `@truthlocks/maip-slack`.
Su autenticación de bot y una presentación autorizada de mensajes de prueba pasaron el proveedor
cheques. Los flujos de trabajo completos de comandos de barra para usuarios personales y eventos alojados permanecen bajo
validación. Siga el [README de Slack](https://github.com/truthlocks/truthlock/tree/main/packages/maip-slack)
para la compilación revisada y todas las configuraciones requeridas.

Vincule la aplicación a `SLACK_TEAM_ID` y a `SLACK_ALLOWED_USER_IDS` personales explícitos.
Use `MAIP_AGENT_ID` de un agente Truthlocks registrado existente para la creación;
un ID de miembro de Slack no es una identidad de máquina. Suministre una clave de sandbox y
`https://sandbox-api.truthlocks.com/v1` durante la evaluación. Los comandos están registrados
en la configuración de la aplicación de Slack. Tanto el modo HTTP como el modo Socket proporcionan `/webhook/maip`, pero
el alojamiento del oyente no suscribe automáticamente los eventos de Truthlocks a él.
Las aprobaciones de delegación permanecen en la revisión autenticada de Console. Protección de reproducción local
es local al proceso; la entrega de producción necesita un seguimiento ascendente duradero.

### Configuración y validación de Notion

Notion es un paquete de origen privado, no una instalación de npm. Aceptación real de QA
creó una página secundaria y esquemas de base de datos, insertó un recibo de espacio de trabajo existente,
repitió la sincronización sin duplicar esa página y verificó la lectura del proveedor.
La automatización alojada continua y la recuperación duradera permanecen en validación.

Conecte solo la página deseada usando el menú **••• → Conexiones** de Notion. Siga las
[README de Notion](https://github.com/truthlocks/truthlock/tree/main/packages/maip-notion)
para inicializar bases de datos una vez y reutilizar sus IDs. Use `WEBHOOK_SECRET` con el
contrato HMAC/marca de tiempo versionado; las solicitudes sin firmar son rechazadas. Estado del recibo
son metadatos, por lo que un recibo completado no verifica automáticamente la noción
cuadro **Verificado**. Utilice la verificación de firma explícita por separado.

## CI/CD

Las entradas de la acción MAIP son `maip-api-url`, `maip-api-key` y `maip-agent-id`.
Los nombres antiguos `api-key` y `agent-id` no son entradas declaradas. Para un revisado
extracción de la fuente con su `dist/index.js` construido, un flujo de trabajo de control de calidad activado explícitamente
puede usar este paso:

```yaml theme={null}
- uses: ./packages/maip-github-action
  with:
    maip-api-url: https://sandbox-api.truthlocks.com/v1
    maip-api-key: ${{ secrets.TRUTHLOCKS_API_KEY }}
    maip-agent-id: ${{ vars.TRUTHLOCKS_AGENT_ID }}
    mode: receipt
    event-type: commit
    create-check: 'false'
    post-comment: 'false'
```

Esta es una ruta de acción local después de la extracción y compilación, no un Marketplace no verificado
etiqueta. Fije las versiones revisadas al distribuir la acción. Verifique/comente la publicación
requiere permisos deliberados de GitHub y aceptación separada; nunca exponga secretos
a flujos de trabajo de bifurcaciones no confiables. Consulte el [README de la acción](https://github.com/truthlocks/truthlock/tree/main/packages/maip-github-action).

## Conectores de modelos de IA

Los "wrappers" de Python capturan los eventos emitidos a través de la integración configurada. Los hashes locales no son firmas de servidor. Las credenciales del proveedor, las credenciales de Truthlocks y el envío alojado se configuran por separado; inspeccione los metadatos que envía y no asuma que el "hashing" elimina las obligaciones de privacidad.

### Marcos de trabajo admitidos

| Framework | Instalar |
| :- | :- |
| LangChain | `pip install truthlocks-langchain` |
| LlamaIndex | `pip install truthlocks-llamaindex` |
| CrewAI | `pip install truthlocks-crewai` |
| AutoGen | `pip install truthlocks-autogen` |
| OpenAI | `pip install truthlocks-openai` |
| Anthropic | `pip install truthlocks-anthropic` |
| AWS Bedrock | `pip install truthlocks-bedrock` |

**Ejemplo completo de LangChain local (sin solicitud alojada):**

```python theme={null}
from langchain_core.runnables import RunnableLambda
from truthlocks_langchain import MAIPRunnableWrapper
from maip_ai_connectors.config import MAIPConfig

chain = RunnableLambda(lambda value: value.upper())
wrapped = MAIPRunnableWrapper(chain, config=MAIPConfig(auto_receipt=False))
print(wrapped.invoke("hello"))
receipts = wrapped.get_receipts()
print(receipts[0].payload_hash)
wrapped.clear_receipts()
```

`payload_hash` describe la evidencia local. Para el envío alojado use `MAIPClient.create_receipt`
y verifique el `receipt_id` del servidor devuelto; el [README de LangChain](https://github.com/truthlocks/truthlock/tree/main/packages/truthlocks-langchain)
contiene el ejemplo de envío asíncrono. Para los "hooks" automáticos asíncronos, vacíe y
cierre el "wrapper" e inspeccione los resultados del envío antes del apagado. Las llamadas fuera del
el "wrapper" configurado no se observan.

## Pipelines de datos y ML

### Conector Kafka

El conector Go envía las huellas digitales de los mensajes como recibos MAIP `data.attestation`
usando un agente existente. Su cliente HTTP usa `/v1/agent-receipts`, conserva parcial
resultados de lotes, y requiere una firma confirmada para una verificación exitosa.

Instale `github.com/truthlocks/kafka-maip-connector@v0.1.0` con `go get`.
Consulte la [versión y el ejemplo completo](https://github.com/truthlocks/kafka-maip-connector/releases/tag/v0.1.0).
La clave API selecciona el espacio de trabajo y el entorno; un ID de inquilino proporcionado por el llamador sí lo hace
no anula la autorización. Los bytes del mensaje y las claves de mensaje sin procesar no se cargan.

Los envoltorios de productor/consumidor almacenan los recibos en memoria. Entrega y recepción del intermediario
la entrega son operaciones separadas; una escritura exitosa en Kafka no garantiza una
el recibo fue retenido. La entrega de auditoría requerida necesita una bandeja de salida de aplicación duradera
y manejo explícito de fallas. Consulte la evidencia de lanzamiento antes de usar en producción.

### Transmisión de eventos

Instale [Go event-stream v0.1.0](https://github.com/truthlocks/maip-event-stream/releases/tag/v0.1.0):

```sh theme={null}
go get github.com/truthlocks/maip-event-stream@v0.1.0
```

La biblioteca incluye un cliente Redis concreto y interfaces de adaptador para NATS
JetStream, EventBridge y Kinesis. Los consumidores que se reconectan a Redis escanean sus propios
entradas pendientes antes de nuevos mensajes; el procesamiento fallido permanece sin reconocer.
Mantenga los nombres de los consumidores estables en los reinicios. Reclamando el pendiente de otro consumidor
las entradas aún requieren un proceso de recuperación explícito. El artefacto publicado pasó
una prueba aislada de reinicio/reconocimiento de Redis real y el conjunto completo de Go race.
Otros adaptadores de backend requieren implementaciones de cliente reales y autenticadas. Estos adaptadores
envolventes de eventos de transporte; no acuñan ni verifican automáticamente firmas MAIP.
La generación de recibos de Kafka es un conector separado, descrito anteriormente.

> [!WARNING]
>
> La puerta de enlace independiente no está lista para su implementación: sus fábricas de clientes de backend
> no están cableados, y ahora se niega a iniciar en lugar de informar no realizados
> publicaciones como aceptadas. No hay `truthlocks_streaming.StreamingGateway` lanzado
> API de Python correspondiente al ejemplo anterior de esta página.

La deduplicación ahora utiliza una caché exacta limitada de identidades de eventos confirmadas, con alcance
al inquilino y a la fuente. Las publicaciones fallidas no se almacenan en caché. Los reintentos por defecto son cero;
los reintentos explícitos proporcionan una entrega al menos una vez, no garantías de exactamente una vez.
El middleware por lotes maneja un evento a la vez, por lo que no puede adivinar los elementos fallidos.
de los recuentos agregados. La eliminación de la caché y el reinicio del proceso pueden permitir duplicados.

El validador de recibos verifica la estructura y los enlaces hash locales; no es una firma
verificador. Mantenga el enrutamiento autenticado, la retención duradera y la validación criptográfica
en el diseño de su aplicación.

### MLflow, DVC y Delta Lake

Instale `mlflow-maip`, `dvc-maip` o `delta-lake-maip` para los metadatos correspondientes
constructores. Estos paquetes producen evidencia estructurada local; instalar uno no
hacer de cada operación de marco un recibo alojado firmado. No hay soporte
`truthlocks_mlflow.TruthlocksPlugin.enable` API correspondiente al ejemplo anterior.

Utilice los ejemplos locales y alojados completos en los README de origen:
[MLflow](https://github.com/truthlocks/truthlock/tree/main/packages/mlflow-maip),
[DVC](https://github.com/truthlocks/truthlock/tree/main/packages/dvc-maip),
[Delta Lake](https://github.com/truthlocks/truthlock/tree/main/packages/delta-lake-maip).
Los metadatos del proveedor y los URI de los artefactos no verifican de forma independiente los bytes del artefacto o
probar que ocurrió una operación externa. La verificación de firma alojada no
establecer la inclusión en el registro de transparencia a menos que esa verificación separada tenga éxito.

## Docker

Los archivos fuente del contenedor no establecen que se haya lanzado una imagen pública o
aceptación aprobada. Las imágenes `truthlocks/*:latest` listadas anteriormente y las combinadas
El ejemplo de composición no ha sido verificado como una implementación funcional y no es un
inicio rápido compatible. No infiera la disponibilidad de la imagen de esos nombres históricos.

Utilice la versión del paquete publicado y su README para cada integración. Si está construyendo
un contenedor de una fuente revisada, fije esa revisión y dependencias, suministre secretos
a través de su tiempo de ejecución, y pruebe la conexión real del proveedor. Slack adicionalmente
requiere sus credenciales de aplicación reales; una clave API de Truthlocks por sí sola es insuficiente.
La puerta de enlace de flujo de eventos independiente sigue sin estar disponible como se describió anteriormente.

## Próximos pasos

> [card] [Identidad de máquina](https://docs.truthlocks.com/guides/machine-identity.md)
>
> Registra tu primer agente y comprende el protocolo MAIP.

> [card] [Autorización del agente](https://docs.truthlocks.com/guides/agent-authorization.md)
>
> Configure ámbitos, sesiones y acceso a herramientas para sus agentes.

> [card] [Descargas](https://truthlocks.com/resources/downloads)
>
> Encuentre las versiones publicadas de CLI, SDK e IDE y sus instrucciones de instalación.

> [card] [Centro de integraciones](https://truthlocks.com/resources/integrations)
>
> Explore todas las integraciones por categoría.

### Lineal

Autenticación de proveedor real, búsqueda de problemas de SDK y un comentario de recibo con lectura
aprobado en un problema de control de calidad explícitamente autorizado. Esto no establece el webhook alojado
creación de recibos o sincronización continua. El oyente de origen verifica Linear's
Firma HMAC y marca de tiempo firmada, y restringe los eventos a la organización configurada
e IDs de equipo. La automatización de hitos del proyecto permanece no disponible en lugar de emitir
evidencia estimada. Consulte la [configuración y límites de Linear](https://github.com/truthlocks/truthlock/tree/main/packages/maip-linear#readme).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.