Koban MCP by usefulapi
Read accounts, leads and deals; save accounts and contacts, add actions in Koban.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin koban_get_account_by_external_code
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"koban": {
"url": "https://koban.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://koban.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (21)
🟢koban_list_users
List the users of the Koban account (login, name, active state). Use it to find the user id for assignments. Koban API: GET /ncAuthenticate/GetUsers.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_search_accounts(search)
Search Koban accounts (companies and persons) by label. Returns matching accounts with status, type and assignment. Koban API: GET /ncThird/GetByLabel.
Eingabe-Schema
{
"type": "object",
"properties": {
"search": {
"type": "string",
"minLength": 1,
"description": "Text to find in the account label."
}
},
"required": [
"search"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_get_account(id)
Get one Koban account by its id, including address, status, type, tags and custom fields. Koban API: GET /ncThird/GetOne.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The Koban object id (GUID, from a list or get tool)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_get_account_by_external_code(extcode)
Get one Koban account by your own external code (Extcode). Use it when your system stores the Koban link by external code. Koban API: GET /ncThird/GetOneByExtcode.
Eingabe-Schema
{
"type": "object",
"properties": {
"extcode": {
"type": "string",
"minLength": 1,
"description": "Your own external code for the record (Koban Extcode)."
}
},
"required": [
"extcode"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_list_updated_accounts(updated, structcode, offset, limit)
List accounts changed after a Unix time, one page at a time. Use it for incremental sync. Koban API: GET /ncThird/GetUpdated.
Eingabe-Schema
{
"type": "object",
"properties": {
"updated": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
},
"structcode": {
"description": "Only accounts of this structure code (optional).",
"type": "string"
},
"offset": {
"description": "Start offset of the page (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Records per page (the vendor examples use 20).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"updated"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_find_contact_by_email(email)
Find Koban contacts by their e-mail address. Returns the matching contacts and their accounts. Koban API: GET /ncContact/GetByEMail.
Eingabe-Schema
{
"type": "object",
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "The e-mail address to find."
}
},
"required": [
"email"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_get_contact(id)
Get one Koban contact by its id, including name, e-mail, phone, function and tags. Koban API: GET /ncContact/GetOne.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The Koban object id (GUID, from a list or get tool)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_list_updated_contacts(updated, offset, limit)
List contacts changed after a Unix time, one page at a time. Use it for incremental sync. Koban API: GET /ncContact/GetUpdated.
Eingabe-Schema
{
"type": "object",
"properties": {
"updated": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
},
"offset": {
"description": "Start offset of the page (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Records per page (the vendor examples use 20).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"updated"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_get_lead(id)
Get one Koban lead by its id, including the person, company, status and tags. Koban API: GET /ncLead/GetOne.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The Koban object id (GUID, from a list or get tool)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_list_leads_by_status(status, offset, sort)
List Koban leads that have one status code (for example MQL), one page at a time. Koban API: GET /ncLead/GetByStatus.
Eingabe-Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"minLength": 1,
"description": "The lead status code from your Koban lists (for example MQL)."
},
"offset": {
"description": "Start offset of the page (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"sort": {
"description": "Sort field for the list, for example CreationDate.",
"type": "string"
}
},
"required": [
"status"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_get_deal(id)
Get one Koban deal by its id, including its process, amount, owner and status. Koban API: GET /ncDeal/GetOne.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The Koban object id (GUID, from a list or get tool)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_list_deals_for_account(account_id)
List all Koban deals linked to one account id. Koban API: GET /ncDeal/GetForThird.
Eingabe-Schema
{
"type": "object",
"properties": {
"account_id": {
"type": "string",
"minLength": 1,
"description": "The account id (GUID) from koban_search_accounts."
}
},
"required": [
"account_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_list_updated_deals(updated, offset, limit)
List deals changed after a Unix time, one page at a time. Use it for incremental sync. Koban API: GET /ncDeal/GetUpdated.
Eingabe-Schema
{
"type": "object",
"properties": {
"updated": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
},
"offset": {
"description": "Start offset of the page (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Records per page (the vendor examples use 20).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"updated"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_get_invoice(id)
Get one Koban invoice by its id, including number, amounts, status and lines. Koban API: GET /ncInvoice/GetOne.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The Koban object id (GUID, from a list or get tool)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_list_updated_invoices(updated, offset, limit)
List invoices changed after a Unix time, one page at a time. Use it for incremental sync. Koban API: GET /ncInvoice/GetUpdated.
Eingabe-Schema
{
"type": "object",
"properties": {
"updated": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
},
"offset": {
"description": "Start offset of the page (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Records per page (the vendor examples use 20).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"updated"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_list_updated_orders(updated, offset, limit)
List orders changed after a Unix time, one page at a time. Koban API: GET /ncOrder/GetUpdated.
Eingabe-Schema
{
"type": "object",
"properties": {
"updated": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
},
"offset": {
"description": "Start offset of the page (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Records per page (the vendor examples use 20).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"updated"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_get_action(id)
Get one Koban action (task, call or meeting) by its id. Koban API: GET /ncAction/Get.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The Koban object id (GUID, from a list or get tool)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢koban_list_pending_actions(user_id, from, to, updated, offset, ...)
List the open actions of one user, optionally in a date range. Koban API: GET /ncAction/GetPending.
Eingabe-Schema
{
"type": "object",
"properties": {
"user_id": {
"description": "The user id (GUID) from koban_list_users.",
"type": "string"
},
"from": {
"description": "Start date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"to": {
"description": "End date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"updated": {
"description": "Only actions changed after this date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"offset": {
"description": "Start offset of the page (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"sort": {
"description": "Sort field for the list, for example CreationDate.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡koban_upsert_account(extcode, label, status_code, type_code, comments)
Create an account, or update the account that has this external code. Existing fields not sent are kept. Koban API: POST /ncThird/PostOne with uniqueproperty=Extcode.
Eingabe-Schema
{
"type": "object",
"properties": {
"extcode": {
"type": "string",
"minLength": 1,
"description": "Your own external code for the record (Koban Extcode)."
},
"label": {
"type": "string",
"minLength": 1,
"description": "The account name (company name or person name)."
},
"status_code": {
"description": "The account status code (for example CLI for a client).",
"type": "string"
},
"type_code": {
"description": "The account type code (for example PRO or PER).",
"type": "string"
},
"comments": {
"description": "Free-text comments on the account.",
"type": "string"
}
},
"required": [
"extcode",
"label"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡koban_upsert_contact(extcode, name, first_name, email, phone, ...)
Create a contact, or update the contact that has this external code. Optionally link it to an account by the account's external code. Koban API: POST /ncContact/PostOne.
Eingabe-Schema
{
"type": "object",
"properties": {
"extcode": {
"type": "string",
"minLength": 1,
"description": "Your own external code for the record (Koban Extcode)."
},
"name": {
"type": "string",
"minLength": 1,
"description": "The contact's last name."
},
"first_name": {
"description": "The contact's first name.",
"type": "string"
},
"email": {
"description": "The contact's e-mail address.",
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"phone": {
"description": "The contact's phone number.",
"type": "string"
},
"cell": {
"description": "The contact's mobile number.",
"type": "string"
},
"function": {
"description": "The contact's job title.",
"type": "string"
},
"account_extcode": {
"description": "External code of the account to link the contact to.",
"type": "string"
}
},
"required": [
"extcode",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴koban_create_action(label, status_code, comments, priority_code, assigned_to_guid, ...)
Create a new action (task, call or meeting) for a user, linked to an account or a deal. Each call creates a new action; a retry creates a duplicate. Koban API: POST /ncAction/Post.
Eingabe-Schema
{
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"description": "The action title."
},
"status_code": {
"type": "string",
"minLength": 1,
"description": "The action status code from your Koban settings (for example NDEM)."
},
"comments": {
"description": "Free-text description of the action.",
"type": "string"
},
"priority_code": {
"description": "The priority code (for example NOR).",
"type": "string"
},
"assigned_to_guid": {
"description": "The user id (GUID) the action is assigned to.",
"type": "string"
},
"account_guid": {
"description": "The account id (GUID) to link the action to.",
"type": "string"
},
"account_extcode": {
"description": "The account external code, if no account id is given.",
"type": "string"
},
"deal_guid": {
"description": "The deal id (GUID) to link the action to.",
"type": "string"
}
},
"required": [
"label",
"status_code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis