SDKs

Syncanix genera una superficie de agente sobre tu API existente: chat dentro de tu app, más un servidor MCP por inquilino para Claude, Cursor y ChatGPT. El agente puede ejecutar acciones sin ningún SDK de servidor, bajo la identidad de cada usuario final. Añade uno cuando quieras que tu backend sea la última línea de defensa: un SDK ligero verifica que cada acción fue realmente autorizada por Syncanix para ese inquilino y usuario antes de ejecutarla.

Qué hace un SDK del lado del servidor

Cada SDK de Syncanix hace un solo trabajo: verificar la cabecera firmada X-Syncanix-Intent que acompaña cada llamada a herramienta entrante. La verificación es una comprobación HMAC rápida y local contra tu secreto de firma de intenciones: sin viajes de red y sin estado compartido.

• Confirma que la solicitud lleva una intención válida y no caducada, firmada por la plataforma Syncanix, no una llamada falsificada o repetida.
• Expone el inquilino y el usuario final que actúan (el sujeto actuar-como-usuario de v2) para que tu handler acote la acción exactamente a ese usuario.
• Se ejecuta por completo dentro del proceso: una comprobación de firma sin estado, con protección opcional contra repetición de un solo uso que conectas a tu propio almacén.

Cuándo añadir uno

No lo necesitas para lanzar: el agente conversa y ejecuta acciones contra tus endpoints descubiertos, tus endpoints personalizados y tus herramientas MCP bajo la identidad de cada usuario final. Añade un SDK de servidor cuando quieras una garantía más fuerte en acciones con efectos secundarios —reembolsos, actualizaciones, cancelaciones—: verifica la intención firmada en cada llamada, de modo que una petición falsificada o repetida que tu plataforma nunca autorizó no llegue a tu lógica de negocio. Recomendado para escrituras sensibles, no un requisito.

Instalación

Añade el SDK del lenguaje de tu backend. Node se configura en el inicio rápido; cada uno de los otros siete lenguajes tiene su propia página.

# Node.js (Express, NestJS, Fastify, Next.js)
npm install @syncanix/sdk-node
# Python (Django, Flask, FastAPI)
pip install syncanix-sdk
# Go (net/http, Gin, Echo, Fiber)
go get github.com/syncanix-ai/syncanix-sdk-go
# Spring Boot (JVM)
implementation "ai.syncanix:syncanix-sdk-spring-boot"
# PHP (Laravel, Symfony)
composer require syncanix/sdk-php
# Ruby (Rails, Rack)
bundle add syncanix-sdk-rails
# Rust (Axum, Actix Web, Tower)
cargo add syncanix-sdk-rust
# .NET (ASP.NET Core)
dotnet add package Syncanix.Sdk.AspNetCore

Elige tu lenguaje

Cada página recorre la instalación del paquete, la configuración del secreto de firma de intenciones y un fragmento de verificación de intención en el framework idiomático de ese lenguaje.

Próximos pasos