Offorte

Crie e envie propostas comerciais usando IA com Offorte.

Documentação

Servidor MCP Offorte

Servidor MCP para Offorte - Crie e envie propostas usando IA.

Este servidor atua como a ponte entre agentes de IA e o mecanismo de propostas da Offorte. Ele permite que modelos externos criem e enviem propostas via Offorte. Construído para fluxos de trabalho de automação, o MCP facilita a integração de ações de propostas em ferramentas de IA, interfaces de chat e sistemas autônomos.

Tecnologia inicial Observe que o MCP (Model Context Protocol) é uma nova abordagem para integração de IA. Embora poderoso, ainda está em evolução e pode ocasionalmente produzir resultados inesperados ou indesejados.

Sobre a Offorte

A Offorte é um software de propostas automatizadas que ajuda empresas a criar, enviar e acompanhar propostas interativas e elegantes. Construída para velocidade, flexibilidade e uso no mundo real, ela combina automação e fluxos de trabalho inteligentes sem sacrificar o toque pessoal. Saiba mais sobre a Offorte.

API

O servidor MCP utiliza a API Pública v2 da Offorte. Leia a documentação da API para mais informações.

Demonstração

Experimente o futuro das propostas: acionadas por voz, alimentadas por IA e totalmente automatizadas. Veja como a Offorte conecta voz e fluxo de trabalho em esta demonstração real.

Objetivos e Cobertura

O objetivo deste projeto é criar e enviar propostas usando IA por meio do protocolo. Devido ao caráter experimental, a API completa da Offorte não é coberta, sendo limitada às ferramentas necessárias para criar e enviar propostas. Ferramentas que poderiam levar um LLM a atualizar e excluir dados ainda não foram implementadas. Comandos de atualização e exclusão podem ser adicionados no futuro, com base em resultados reais e feedback dos usuários.

Pré-requisitos

Node.js (testado com Node.js 20.x.x)
Chave de API da Offorte (veja a Seção de Autenticação da Documentação da API da Offorte)
PNPM para desenvolvimento
TRANSPORT_TYPE (opcional): Defina como sse para habilitar o modo Server-Sent Events (SSE), ou deixe sem definição/padrão para stdio (padrão: stdio).

Ferramentas Disponíveis

Contexto e Configuração

get_initial_context – IMPORTANTE: Deve ser chamado antes de usar qualquer outra ferramenta para inicializar o contexto e obter instruções de uso

Conta

get_users – Lista todos os usuários da conta para a conta atual

Automações

get_automation_sets – Lista conjuntos de automação usados como entrada opcional para criar uma nova proposta

Contatos

create_contact – Cria um novo contato (organização ou pessoa/indivíduo)
get_contact_details - Obtém todos os detalhes de um contato por id
search_contact_organisations - Busca organizações por nome nos contatos
search_contact_people - Busca pessoas por nome nos contatos

Favoritos

get_proposal_templates – Lista modelos de propostas usados como pontos de partida para criar novas propostas

Propostas

create_proposal – Cria uma nova proposta
get_proposal_directories – Obtém todos os diretórios de propostas agrupados por status
search_proposals – Busca propostas por consulta
send_proposal – Envia uma proposta para seus contatos designados

Configurações

get_design_templates – Lista modelos de design disponíveis usados para criar novas propostas
get_email_templates – Lista modelos de e-mail disponíveis usados para enviar propostas
get_text_templates – Lista modelos de texto de idioma disponíveis usados para criar novas propostas

Clientes MCP

Atualmente, este servidor MCP foi testado apenas com o Claude Desktop. Mais exemplos de clientes serão adicionados no futuro.

Configuração do Claude Desktop

Encontre seu claude_desktop_config.json em Claude > Settings > Developer > Edit Config e, dependendo da opção desejada, adicione APENAS UMA das seguintes:

NPX

Executando diretamente do 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

As dependências devem ter sido instaladas e o projeto deve ser 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>"
			}
		}
	}
}

Desenvolvimento

Para começar, clone o repositório e instale as dependências. Certifique-se de ter um arquivo .env e que ele inclua os valores adequados.

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

Comandos

Verifique os scripts NPM para todos os comandos; abaixo está um breve resumo dos mais importantes.

Script	Informações
`pnpm build`	Compila o projeto para produção
`pnpm start`	Inicia o servidor de produção
`pnpm dev`	Inicia o servidor de desenvolvimento
`pnpm inspect`	Inspeciona o servidor
`pnpm format`	Formata o código usando Prettier e ESLint