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

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
96%
Qualität der Benennung
79%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (1)

  • LOWTool 'koban_get_account_by_external_code' name length outside 3-30 rangein koban_get_account_by_external_code

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~3,668Tokens (Tool-Definitionen)
~1.2 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.87% von 128k Kontext)

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-http

Was es kann

Tool-Inventar

Tools (21)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet21 Tools