Offorte

Crea y envía propuestas comerciales usando IA con Offorte.

Documentación

Offorte MCP Server

Servidor MCP para Offorte: crea y envía propuestas usando IA.

Este servidor actúa como puente entre los agentes de IA y el motor de propuestas de Offorte. Permite que modelos externos creen y envíen propuestas a través de Offorte. Diseñado para flujos de trabajo automatizados, el MCP facilita la integración de acciones de propuestas en herramientas de IA, interfaces de chat y sistemas autónomos.

Tecnología temprana Ten en cuenta que MCP (Model Context Protocol) es un enfoque nuevo para la integración de IA. Aunque es potente, aún está evolucionando y puede producir ocasionalmente resultados inesperados o no deseados.

Acerca de Offorte

Offorte es un software de propuestas automatizadas que ayuda a las empresas a crear, enviar y realizar un seguimiento de propuestas interactivas y atractivas. Diseñado para la velocidad, la flexibilidad y el uso real, combina automatización y flujos de trabajo inteligentes sin sacrificar el toque personal. Obtén más información sobre Offorte.

API

El servidor MCP utiliza la API pública v2 de Offorte. Lee la documentación de la API para obtener más información.

Demo

Experimenta el futuro de las propuestas: activadas por voz, impulsadas por IA y totalmente automatizadas. Mira cómo Offorte conecta la voz y el flujo de trabajo en esta demo real.

Objetivos y cobertura

El objetivo de este proyecto es crear y enviar propuestas usando IA a través del protocolo. Debido al carácter experimental, no se cubre toda la API de Offorte y se limita a las herramientas necesarias para crear y enviar propuestas. Las herramientas que podrían llevar a un LLM a actualizar y eliminar contenido aún no están implementadas. Los comandos de actualización y eliminación podrían agregarse en el futuro, según los resultados reales y los comentarios de los usuarios.

Requisitos previos

Node.js (probado con Node.js 20.x.x)
Clave de API de Offorte (consulta la Sección de autenticación de la documentación de la API de Offorte)
PNPM para desarrollo
TRANSPORT_TYPE (opcional): Establécelo en sse para habilitar el modo Server-Sent Events (SSE), o déjalo sin establecer/por defecto para stdio (por defecto: stdio).

Herramientas disponibles

Contexto y configuración

get_initial_context – IMPORTANTE: Debe llamarse antes de usar cualquier otra herramienta para inicializar el contexto y obtener instrucciones de uso.

Cuenta

get_users – Lista todos los usuarios de la cuenta para la cuenta actual

Automatizaciones

get_automation_sets – Lista los conjuntos de automatización que se utilizan como entrada opcional para crear una nueva propuesta

Contactos

create_contact – Crea un nuevo contacto (organización o persona/individuo)
get_contact_details - Obtiene todos los detalles de un contacto por id
search_contact_organisations - Busca organizaciones por nombre en los contactos
search_contact_people - Busca personas por nombre en los contactos

Favoritos

get_proposal_templates – Lista las plantillas de propuestas que se utilizan como puntos de partida para crear nuevas propuestas

Propuestas

create_proposal – Crea una nueva propuesta
get_proposal_directories – Obtiene todos los directorios de propuestas agrupados por estado
search_proposals – Busca propuestas por consulta
send_proposal – Envía una propuesta a sus contactos asignados

Configuración

get_design_templates – Lista las plantillas de diseño disponibles que se utilizan para crear nuevas propuestas
get_email_templates – Lista las plantillas de correo electrónico disponibles que se utilizan para enviar propuestas
get_text_templates – Lista las plantillas de texto de idioma disponibles que se utilizan para crear nuevas propuestas

Clientes MCP

Actualmente, este servidor MCP solo se ha probado con Claude Desktop. Se agregarán más ejemplos de clientes en el futuro.

Configuración de Claude Desktop

Encuentra tu claude_desktop_config.json en Claude > Settings > Developer > Edit Config y, según la opción que prefieras, agrega SOLO UNA de las siguientes:

NPX

Ejecutándolo directamente desde el registro npm.

{
	"mcpServers": {
		"offorte-proposals": {
			"command": "npx",
			"args": ["-y", "@offorte/mcp-server"],
			"env": {
				"OFFORTE_ACCOUNT_NAME": "<YOUR_ACCOUNT_NAME>",
				"OFFORTE_API_KEY": "<YOUR_TOKEN>"
			}
		}
	}
}

Node local

Las dependencias deben haberse instalado y el proyecto debe estar compilado antes de usar este método (pnpm install).

{
	"mcpServers": {
		"offorte-proposals": {
			"command": "node",
			"args": ["/path/to/directory/offorte-mcp-server/dist/server.js"],
			"env": {
				"OFFORTE_ACCOUNT_NAME": "<YOUR_ACCOUNT_NAME>",
				"OFFORTE_API_KEY": "<YOUR_TOKEN>"
			}
		}
	}
}

Desarrollo

Para comenzar, clona el repositorio e instala las dependencias. Asegúrate de tener un archivo .env y de que incluya los valores adecuados.

git clone https://github.com/offorte/offorte-mcp-server.git
cd offorte-mcp-server
pnpm install
pnpm dev

Comandos

Consulta los scripts de NPM para todos los comandos; a continuación se muestra un breve resumen de los más importantes.

Script	Info
`pnpm build`	Compila el proyecto para producción
`pnpm start`	Inicia el servidor de producción
`pnpm dev`	Inicia el servidor de desarrollo
`pnpm inspect`	Inspecciona el servidor
`pnpm format`	Formatea el código usando Prettier y ESLint