Koban MCP by usefulapi
Read accounts, leads and deals; save accounts and contacts, add actions in Koban.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWkoban_get_account_by_external_code에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"koban": {
"url": "https://koban.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://koban.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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"
}커뮤니티
증거