Сервер Model Context Protocol (MCP), который обеспечивает бесшовную интеграцию с Twenty CRM API, позволяя агентам LLM взаимодействовать с вашими данными CRM с помощью четко определенных, типизированных инструментов.

of Содержание

• Обзор
• Предварительные условия Быстрый старт
• Установка
• Конфигурация
• Аутентификация OAuth
• Проверка Интеграция IDE
• Использование
• Устранение неполадок
• Дополнительные ресурсы

Обзор

Этот MCP-сервер превращает ваш экземпляр Twenty CRM в мощный инструмент, доступный Клоду и другим ИИ-ассистентам, совместимым с MCP. Он обеспечивает полный доступ к контактам, компаниям, задачам и заметкам с полной поддержкой TypeScript и надежной обработкой ошибок.

Ключевые особенности

** Контактное управление**: Создавать, извлекать, обновлять и искать контакты *** Управление компанией**: Управление жизненным циклом компании *** Отслеживание возможностей**: полное управление продажами *** Управление деятельностью**: Унифицированный вид временной шкалы с фильтрацией ***** Управление задачами**: Создание и управление задачами *** Управление взаимоотношениями**: Связывайте сущности и анализируйте связи ** Metadata Discovery**: Изучите схему CRM и определения полей

• *** OAuth 2.

Twenty MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with the Twenty CRM API, enabling LLM agents to interact with your CRM data through well-defined, typed tools.

📋 Table of Contents

• Overview
• Prerequisites
• Quick Start
• Installation
• Configuration
• OAuth Authentication
• Verification
• IDE Integration
• Usage
• Troubleshooting
• Additional Resources

Overview

This MCP server transforms your Twenty CRM instance into a powerful tool accessible by Claude and other MCP-compatible AI assistants. It provides comprehensive access to contacts, companies, tasks, and notes with full TypeScript support and robust error handling.

Key Features

• 🤝 Contact Management: Create, retrieve, update, and search contacts
• 🏢 Company Management: Full company lifecycle management
• 💼 Opportunity Tracking: Complete sales pipeline management
• 📝 Activity Management: Unified timeline view with filtering
• ✅ Task Management: Create and manage tasks
• 🔗 Relationship Management: Link entities and analyze connections
• 🔍 Metadata Discovery: Explore CRM schema and field definitions
• 🔐 OAuth 2.1 Authentication: Secure user-specific API key management
• 🔒 Full TypeScript Support: Type-safe operations with validation

Total: 29 MCP Tools providing comprehensive CRM automation capabilities. See full tool list →

Understanding MCP Servers

MCP (Model Context Protocol) servers are tools that extend AI assistants like Claude with new capabilities. Once configured, this server allows Claude to:

• 🔍 Read your CRM data (contacts, companies, opportunities)
• ✍️ Create new records directly from conversations
• 🔄 Update existing information
• 🤖 Automate CRM workflows through natural language

Think of it as giving Claude direct access to your Twenty CRM, turning it into a powerful CRM assistant.

Prerequisites

Before installing, ensure you have:

• ✅ Node.js 18 or higher - Download from nodejs.org
• ✅ npm (included with Node.js)
• ✅ Git for cloning the repository
• ✅ Twenty CRM instance with API access
• ✅ Text editor for configuration files

Checking Prerequisites

# Check Node.js version (should be 18+)
node --version

# Check npm is installed
npm --version