Capsule CRM MCP sunucusu
Commit 13 Kas 2026Claude'u Capsule CRM'inize bağlayarak kişiler, fırsatlar, projeler, görevler ve zaman çizelgesi etkinliklerini doğal dil kullanarak yönetin.
Ayrıca bilinen adı soil-dev/capsulemcp
- Yıldızlar
- 5
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 13 Kas 2026
- Lisans
- Apache-2.0
Capsule CRM MCP nedir?
Claude'u Capsule CRM'inize bağlayarak kişiler, fırsatlar, projeler, görevler ve zaman çizelgesi etkinliklerini doğal dil kullanarak yönetin.
Özet, projenin README dosyasından oluşturuldu
Capsule CRM MCP sunucusu hakkında
capsulemcp, Capsule CRM kullanıcılarının CRM verilerini doğal dil konuşmaları aracılığıyla yönetmesini sağlar. Claude Desktop, Claude Code veya web Projects üzerinden bir Custom Connector aracılığıyla bağlanarak; kişiler, organizasyonlar, fırsatlar, projeler ve görevler dahil olmak üzere tüm kayıt grafiğinizle etkileşime girebilirsiniz. Sunucu, basit aramalardan alan ve operatör koşullarına sahip yapılandırılmış filtreler kullanarak karmaşık sorgulara kadar verilerinizi derinlemesine incelemenize olanak tanıyan 92 araç sunar.
Geliştiriciler, stdio kullanarak yerel bir kurulum veya HTTP ve OAuth kullanarak barındırılan bir kurulum arasında seçim yapabilirler. Veri güvenliğine öncelik verenler için sunucu, bir ortam değişkeni aracılığıyla salt okunur mod ve yıkıcı eylemleri belirten özel araç açıklamaları içerir. Ayrıca toplu güncellemeler için toplu işlemleri destekler ve okuma ile yazma yetenekleri aracılığıyla dosya eki yönetimini sağlar. İster silinen kayıtları denetliyor olun ister iş akışı takipleri yönetiyor olun, bu konektör CRM'iniz ile yapay zeka asistanınız arasındaki boşluğu doldurur.
Neler yapabilirsiniz
- 1CRM kayıtlarını sorgulamaDoğal dil soruları kullanarak belirli kişileri veya fırsatları bulması için yapay zeka asistanınızdan yardım isteyin.
- 2Toplu güncellemeler gerçekleştirmeCRM iş akışlarınızda birden fazla kaydı aynı anda güncellemek için toplu araçları kullanın.
- 3Karmaşık veri filtreleri uygulamaCRM sonuçlarınızı daraltmak için belirli alan ve operatör koşullarına sahip yapılandırılmış filtreler uygulayın.
- 4Proje dosyalarını yönetmeDosyaları doğrudan CRM kayıtlarınıza okuyarak veya yazarak dosya eklerini yönetin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Yapılandırma
CAPSULE_API_TOKENCAPSULE_MCP_READONLY
| Ad | Açıklama | Sunucu |
|---|---|---|
| CAPSULE_API_TOKEN | — | |
| CAPSULE_MCP_READONLY | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirsoil-dev/capsulemcp is public and reachablegithub.com/soil-dev/capsulemcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-13github.com/soil-dev/capsulemcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
capsulemcp
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.
Capsule CRM MCP soruları
Sunucunun yalnızca okuma işlemleri yapmasını nasıl sağlayabilirim?
Tüm yazma ve silme araçlarını MCP katmanında devre dışı bırakmak için CAPSULE_MCP_READONLY ortam değişkenini 1 olarak ayarlayabilirsiniz.
Bunu Claude Desktop için yerel olarak nasıl kurabilirim?
Yerel kurulum için, capsulemcp paketini çalıştırmak üzere npx kullanan bir JSON kod parçasını Claude Desktop yapılandırma dosyanıza ekleyin.
Sunucu toplu güncellemeleri destekliyor mu?
Evet, toplu güncelleme iş akışları için kullanılabilen 6 adet toplu yazma aracı bulunmaktadır.
Yıkıcı eylemlerin kazara gerçekleşmesi nasıl önleniyor?
Yıkıcı araçlar 'confirm: true' argümanı gerektirir; ayrıca sistem, derinlemesine savunma için okuma kapsamlı tokenlar ve salt okunur mod bayrağı ile tasarlanmıştır.