Koban MCP by usefulapi
Read accounts, leads and deals; save accounts and contacts, add actions in Koban.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (1)
- LOWen koban_get_account_by_external_code
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"koban": {
"url": "https://koban.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://koban.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
}Comunidad
Evidencia