Serveur MCP Capsule CRM
Commit 13 nov. 2026Connectez Claude à votre compte Capsule CRM pour gérer vos contacts, opportunités, projets, tâches et l'historique de vos activités en langage naturel.
Aussi connu sous soil-dev/capsulemcp
- Étoiles
- 5
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 13 nov. 2026
- Licence
- Apache-2.0
Qu'est-ce que Capsule CRM MCP ?
Connectez Claude à votre compte Capsule CRM pour gérer vos contacts, opportunités, projets, tâches et l'historique de vos activités en langage naturel.
Résumé généré à partir du README du projet
À propos du MCP server Capsule CRM
La gestion des données CRM via des conversations en langage naturel est ce que capsulemcp permet aux utilisateurs de Capsule CRM. En connectant Claude Desktop, Claude Code ou des projets web via un Custom Connector, vous pouvez interagir avec l'ensemble de votre graphe de données, incluant les contacts, les organisations, les opportunités, les projets et les tâches. Le serveur propose 92 outils permettant une exploration approfondie de vos données, allant de recherches simples à des requêtes complexes utilisant des filtres structurés avec des conditions de champs et d'opérateurs.
Les développeurs peuvent choisir entre une installation locale via stdio ou une configuration hébergée via HTTP et OAuth. Pour ceux qui privilégient la sécurité des données, le serveur inclut un mode lecture seule via une variable d'environnement et des annotations d'outils spécifiques qui signalent les actions destructives. Il prend également en charge les opérations par lots pour les mises à jour massives et permet la gestion des pièces jointes grâce à des capacités de lecture et d'écriture. Que vous auditiez des enregistrements supprimés ou que vous gériez des flux de travail, ce connecteur comble le fossé entre votre CRM et votre assistant IA.
Ce que vous pouvez faire avec
- 1Interroger les enregistrements CRMDemandez à votre assistant IA de trouver des contacts ou des opportunités spécifiques en utilisant le langage naturel.
- 2Effectuer des mises à jour massivesUtilisez les outils par lots pour mettre à jour plusieurs enregistrements simultanément au sein de vos flux de travail CRM.
- 3Exécuter des filtres de données complexesAppliquez des filtres structurés avec des conditions de champs et d'opérateurs spécifiques pour affiner vos résultats CRM.
- 4Gérer les fichiers de projetGérez les pièces jointes en lisant ou en écrivant des fichiers directement dans vos enregistrements CRM.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Configuration
CAPSULE_API_TOKENCAPSULE_MCP_READONLY
| Nom | Description | Type |
|---|---|---|
| CAPSULE_API_TOKEN | — | |
| CAPSULE_MCP_READONLY | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblesoil-dev/capsulemcp is public and reachablegithub.com/soil-dev/capsulemcp ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-13github.com/soil-dev/capsulemcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubcapsulemcp
A Model Context Protocol server for Capsule CRM. Connect Claude (Desktop, Code, or web Projects via Custom Connector) to your CRM and let it answer natural-language questions across the full record graph: contacts, organisations, opportunities, projects, tasks, and timeline activity. Beyond the basics it covers structured filters with field/operator conditions, saved searches with sort, workflow tracks (templates and instances), file attachments (read + write), audit of deleted records, and batch fetches up to 50 records per call.
- 92 tools across the Capsule resource graph (53 in read-only mode) — full read coverage plus careful, confirm-gated writes; 6 batched-write tools (
batch_*) for mass-update workflows - Two transports: stdio for local installs (Claude Desktop / Code), HTTP+OAuth for hosted Custom Connectors — with an unauthenticated
GET /healthtoken-health page for uptime monitoring - Read-only mode as a one-env-var flag; works alongside read-scoped Capsule tokens
- MCP tool annotations: 53 read tools carry
readOnlyHint: true, 8 destructive ones carrydestructiveHint: true— clients that honor these hints can auto-approve safe reads while still prompting for writes/destructive calls - Apache 2.0
Pick your install
| You want | Read this |
|---|---|
| Example questions to ask once the connector is running | EXAMPLES.md |
| To use it locally with Claude Desktop or Claude Code | INSTALL.md |
| To deploy it once and have your whole team use it via Claude.ai | DEPLOY.md |
| To wire it into n8n workflows | INTEGRATIONS-n8n.md |
| To contribute, debug, add a tool, or cut a release | HOWTO.md (procedures) · CONTRIBUTING.md (style & PR checks) |
| To understand what's intentionally not implemented (and why) | DESIGN.md |
| To see what performance work has been done (and what's next) | OPTIMIZATIONS.md |
| To see ideas for features that might land in future versions | IDEAS.md |
| To learn the surprising parts of Capsule's v2 API (with verbatim doc quotes) | NOTES-ON-CAPSULE-API.md |
For most individual users the install is a single JSON snippet pasted into Claude Desktop's config — see INSTALL.md.
Quick start (Claude Desktop)
-
Generate a Capsule API token: My Preferences → API Authentication Tokens → Generate, choose the Read scope for safety.
-
Add this to your
claude_desktop_config.json(~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS):{ "mcpServers": { "capsule": { "command": "npx", "args": ["-y", "capsulemcp@2.5.0"], "env": { "CAPSULE_API_TOKEN": "<paste token here>", "CAPSULE_MCP_READONLY": "1" } } } } -
Restart Claude Desktop. The Capsule tools appear in the tool picker.
That's it. The first launch fetches the package from npm (a few seconds); subsequent launches are instant from the npx cache. The snippet pins an exact version on purpose: the connector runs with your Capsule token in its environment, so you should decide when new code runs with it — upgrade by changing the version after reading the release notes. Plain "capsulemcp" (unpinned) always runs the newest release instead; see INSTALL.md for the trade-off and how to verify a release's provenance. If you're tracking a fork or an unreleased branch, use the GitHub-ref form: "github:soil-dev/capsulemcp#v2.5.0" — same arguments, installs from a git clone rather than the npm registry. See INSTALL.md for the Claude Code path, manual install, and troubleshooting.
Tools
| Group | Read | Write |
|---|---|---|
| Parties (people/orgs) | search_parties, filter_parties, get_party, get_parties, list_employees, list_party_opportunities, list_party_projects, list_party_entries |
create_party, update_party, delete_party, add_party_email_address, remove_party_email_address_by_id, add_party_phone_number, remove_party_phone_number_by_id, add_party_address, remove_party_address_by_id, add_party_website, remove_party_website_by_id |
| Opportunities | search_opportunities, filter_opportunities, get_opportunity, get_opportunities, list_opportunity_entries, list_associated_projects |
create_opportunity, update_opportunity, delete_opportunity |
| Projects | search_projects, list_projects, filter_projects, get_project, get_projects, list_project_entries |
create_project, update_project, delete_project |
| Additional parties (multi-party deals) | list_additional_parties |
add_additional_party, remove_additional_party |
| Tasks | list_tasks, get_task, get_tasks |
create_task, update_task, complete_task, delete_task |
| Entries (notes / captured emails) | get_entry, list_entries |
add_note, update_entry, delete_entry |
| Attachments (file upload / download) | get_attachment |
upload_attachment |
| Activity feed (tenant-wide) | list_activities |
— |
| Audit (deleted records) | list_deleted_parties, list_deleted_opportunities, list_deleted_projects |
— |
| Pipelines & milestones (opportunities) | list_pipelines, list_milestones |
— |
| Boards & stages (projects) | list_boards, list_stages |
— |
| Tracks (workflow instances) | list_track_definitions, list_entity_tracks, get_track |
apply_track, update_track, remove_track |
| Saved filters | list_saved_filters, run_saved_filter |
— |
| Custom fields (schema) | list_custom_fields, get_custom_field |
— |
| Tags | list_tags |
add_tag, remove_tag_by_id, delete_tag_definition |
| Users & teams | list_users, get_current_user, list_teams |
— |
| Reference metadata | list_lost_reasons, list_activity_types, list_categories, list_goals, list_countries, list_currencies, get_site |
— |
Most record-list tools default perPage=25; reference-data tools default perPage=100 so small accounts usually fit in one response. All paginated tools cap perPage at 100 and return a nextPage cursor when more results exist. Many GET tools accept an embed parameter (e.g. tags,fields) — each tool's description enumerates its valid tokens (validated per resource; unknown tokens are rejected rather than silently ignored, and the caller-facing project token maps to Capsule's legacy kase on the wire).
The filter_* tools wrap Capsule's structured filter endpoint (POST /<entity>/filters/results) and accept an array of {field, operator, value} conditions ANDed together. Capsule's API does not support ad-hoc sort, so for "most recent X" questions filter by a date condition (e.g. addedOn is within last 7) and pick the highest id from the result — Capsule's numeric IDs are monotonically incrementing.
If you want sortable queries, use saved filters instead. Create the filter once in Capsule's web UI (it lets you set conditions, columns, and orderBy), then call run_saved_filter with its id. Use list_saved_filters to discover what's available.
Read-only mode
Set CAPSULE_MCP_READONLY=1 to disable every write/delete tool at the MCP layer (none of create_*, update_*, complete_task, add_note, or delete_* are registered). Pair it with a Capsule token that has the Read scope for defence in depth — your token's scope is the hard ceiling regardless of the env var.
Delete safety
Every whole-record delete_* tool, plus remove_track and remove_additional_party, requires confirm: true in its arguments. Without it, the schema rejects the call before any HTTP is made. Tool descriptions tell Claude to read the entity first and confirm with the user before invoking. The combined design — read-scoped token, read-only mode flag, schema-level confirm gate — means destructive actions are deliberate, not accidental.
License
Apache License 2.0 — Copyright 2026 Anton Arapov.
Questions sur Capsule CRM MCP
Comment puis-je m'assurer que le serveur effectue uniquement des opérations de lecture ?
Vous pouvez définir la variable d'environnement CAPSULE_MCP_READONLY sur 1 pour désactiver tous les outils d'écriture et de suppression au niveau du MCP.
Comment installer ce serveur localement pour Claude Desktop ?
Pour une installation locale, ajoutez un extrait JSON à votre fichier de configuration Claude Desktop en utilisant npx pour exécuter le package capsulemcp.
Le serveur prend-il en charge les mises à jour par lots ?
Oui, 6 outils de traitement par lots sont disponibles pour les flux de travail de mise à jour massive.
Comment les actions destructives sont-elles évitées par accident ?
Les outils destructifs nécessitent un argument 'confirm: true', et le système est conçu avec des jetons à portée de lecture et un indicateur de mode lecture seule pour une sécurité renforcée.