Copper MCP by usefulapi
Read and write Copper CRM people, companies, opportunities and activities.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"copper": {
"url": "https://copper.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://copper.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (22)
🟢copper_get_account
Get details of the authenticated Copper account. Copper REST: GET /account.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_list_users(page_number, page_size)
List users in the Copper account (id, name, email) — useful for resolving assignee ids. Copper REST: POST /users/search.
입력 스키마
{
"type": "object",
"properties": {
"page_number": {
"description": "1-based page number to fetch (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"page_size": {
"description": "Results per page (default 20, max 200).",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_search_people(name, emails, phone_number, assignee_ids, company_ids, ...)
Search/list people (contacts). All filters optional; returns a page of people. Copper REST: POST /people/search.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"description": "Full-name filter (substring match).",
"type": "string"
},
"emails": {
"description": "Filter to people with any of these email addresses.",
"type": "array",
"items": {
"type": "string"
}
},
"phone_number": {
"description": "Phone-number filter.",
"type": "string"
},
"assignee_ids": {
"description": "Filter to people owned by these user ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"company_ids": {
"description": "Filter to people at these company ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"tags": {
"description": "Filter to people carrying any of these tags.",
"type": "array",
"items": {
"type": "string"
}
},
"city": {
"description": "City filter.",
"type": "string"
},
"state": {
"description": "State/region filter.",
"type": "string"
},
"country": {
"description": "Country filter.",
"type": "string"
},
"sort_by": {
"description": "Field to sort by, e.g. 'name', 'date_created', 'date_modified' (default 'first_name').",
"type": "string"
},
"sort_direction": {
"description": "Sort direction — 'asc' or 'desc' (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page_number": {
"description": "1-based page number to fetch (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"page_size": {
"description": "Results per page (default 20, max 200).",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_get_person(id)
Get a single person (contact) by id. Copper REST: GET /people/{id}.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The person id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_search_companies(name, assignee_ids, tags, city, state, ...)
Search/list companies. All filters optional; returns a page of companies. Copper REST: POST /companies/search.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"description": "Company-name filter (substring match).",
"type": "string"
},
"assignee_ids": {
"description": "Filter to companies owned by these user ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"tags": {
"description": "Filter to companies carrying any of these tags.",
"type": "array",
"items": {
"type": "string"
}
},
"city": {
"description": "City filter.",
"type": "string"
},
"state": {
"description": "State/region filter.",
"type": "string"
},
"country": {
"description": "Country filter.",
"type": "string"
},
"sort_by": {
"description": "Field to sort by, e.g. 'name', 'date_created' (default 'name').",
"type": "string"
},
"sort_direction": {
"description": "Sort direction — 'asc' or 'desc' (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page_number": {
"description": "1-based page number to fetch (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"page_size": {
"description": "Results per page (default 20, max 200).",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_get_company(id)
Get a single company by id. Copper REST: GET /companies/{id}.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The company id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_search_opportunities(name, assignee_ids, pipeline_ids, pipeline_stage_ids, company_ids, ...)
Search/list opportunities (deals). All filters optional; returns a page of opportunities. Copper REST: POST /opportunities/search.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"description": "Opportunity-name filter (substring match).",
"type": "string"
},
"assignee_ids": {
"description": "Filter to opportunities owned by these user ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"pipeline_ids": {
"description": "Filter to opportunities in these pipelines.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"pipeline_stage_ids": {
"description": "Filter to opportunities at these pipeline stages.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"company_ids": {
"description": "Filter to opportunities at these company ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"status_ids": {
"description": "Filter by status id: 0=Open, 1=Won, 2=Lost, 3=Abandoned.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"tags": {
"description": "Filter to opportunities carrying any of these tags.",
"type": "array",
"items": {
"type": "string"
}
},
"sort_by": {
"description": "Field to sort by, e.g. 'name', 'date_created', 'monetary_value' (default 'name').",
"type": "string"
},
"sort_direction": {
"description": "Sort direction — 'asc' or 'desc' (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page_number": {
"description": "1-based page number to fetch (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"page_size": {
"description": "Results per page (default 20, max 200).",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_get_opportunity(id)
Get a single opportunity (deal) by id. Copper REST: GET /opportunities/{id}.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The opportunity id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_search_leads(name, emails, assignee_ids, customer_source_ids, tags, ...)
Search/list leads. All filters optional; returns a page of leads. Copper REST: POST /leads/search.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"description": "Lead-name filter (substring match).",
"type": "string"
},
"emails": {
"description": "Filter to leads with any of these email addresses.",
"type": "array",
"items": {
"type": "string"
}
},
"assignee_ids": {
"description": "Filter to leads owned by these user ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"customer_source_ids": {
"description": "Filter by customer-source ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"tags": {
"description": "Filter to leads carrying any of these tags.",
"type": "array",
"items": {
"type": "string"
}
},
"city": {
"description": "City filter.",
"type": "string"
},
"state": {
"description": "State/region filter.",
"type": "string"
},
"country": {
"description": "Country filter.",
"type": "string"
},
"sort_by": {
"description": "Field to sort by, e.g. 'name', 'date_created' (default 'name').",
"type": "string"
},
"sort_direction": {
"description": "Sort direction — 'asc' or 'desc' (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page_number": {
"description": "1-based page number to fetch (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"page_size": {
"description": "Results per page (default 20, max 200).",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_get_lead(id)
Get a single lead by id. Copper REST: GET /leads/{id}.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The lead id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_search_tasks(name, assignee_ids, status, sort_by, sort_direction, ...)
Search/list tasks. All filters optional; returns a page of tasks. Copper REST: POST /tasks/search.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"description": "Task-name filter (substring match).",
"type": "string"
},
"assignee_ids": {
"description": "Filter to tasks owned by these user ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"status": {
"description": "Filter by task status.",
"type": "string",
"enum": [
"Open",
"Completed"
]
},
"sort_by": {
"description": "Field to sort by, e.g. 'name', 'due_date', 'date_created' (default 'name').",
"type": "string"
},
"sort_direction": {
"description": "Sort direction — 'asc' or 'desc' (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page_number": {
"description": "1-based page number to fetch (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"page_size": {
"description": "Results per page (default 20, max 200).",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_get_task(id)
Get a single task by id. Copper REST: GET /tasks/{id}.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The task id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_list_activities(parent_type, parent_id, minimum_activity_date, maximum_activity_date, page_number, ...)
List activities (notes, calls, meetings, system events) attached to a record. Copper REST: POST /activities/search.
입력 스키마
{
"type": "object",
"properties": {
"parent_type": {
"description": "Restrict to activities on a single record of this type (requires parent_id).",
"type": "string",
"enum": [
"lead",
"person",
"company",
"opportunity",
"project",
"task"
]
},
"parent_id": {
"description": "The id of the parent record to list activities for (requires parent_type).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"minimum_activity_date": {
"description": "Earliest activity date, as a Unix timestamp (seconds).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"maximum_activity_date": {
"description": "Latest activity date, as a Unix timestamp (seconds).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"page_number": {
"description": "1-based page number to fetch (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"page_size": {
"description": "Results per page (default 20, max 200).",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_list_activity_types
List the account's activity types (user + system), needed to log an activity. Copper REST: GET /activity_types.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢copper_list_pipelines
List sales pipelines and their stages (ids needed to place opportunities). Copper REST: GET /pipelines.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴copper_create_person(name, emails, phone_numbers, title, company_id, ...)
Create a new person (contact). Copper REST: POST /people.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The person's full name (required)."
},
"emails": {
"description": "Email addresses for the person.",
"type": "array",
"items": {
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Email address."
},
"category": {
"description": "Category label, e.g. 'work' or 'home' (default 'work').",
"type": "string"
}
},
"required": [
"email"
],
"description": "An email entry."
}
},
"phone_numbers": {
"description": "Phone numbers for the person.",
"type": "array",
"items": {
"type": "object",
"properties": {
"number": {
"type": "string",
"description": "Phone number."
},
"category": {
"description": "Category label, e.g. 'work', 'mobile', 'home'.",
"type": "string"
}
},
"required": [
"number"
],
"description": "A phone-number entry."
}
},
"title": {
"description": "Job title.",
"type": "string"
},
"company_id": {
"description": "Id of the company this person works at.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"company_name": {
"description": "Company name (if not linking by company_id).",
"type": "string"
},
"assignee_id": {
"description": "User id to own this person.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"tags": {
"description": "Tags to apply.",
"type": "array",
"items": {
"type": "string"
}
},
"details": {
"description": "Freeform description / notes.",
"type": "string"
}
},
"required": [
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴copper_update_person(id, name, emails, phone_numbers, title, ...)
Update fields on an existing person. Only provided fields are changed. Copper REST: PUT /people/{id}.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The person id to update."
},
"name": {
"description": "The person's full name.",
"type": "string"
},
"emails": {
"description": "Replace the person's email addresses.",
"type": "array",
"items": {
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Email address."
},
"category": {
"description": "Category label, e.g. 'work' or 'home' (default 'work').",
"type": "string"
}
},
"required": [
"email"
],
"description": "An email entry."
}
},
"phone_numbers": {
"description": "Replace the person's phone numbers.",
"type": "array",
"items": {
"type": "object",
"properties": {
"number": {
"type": "string",
"description": "Phone number."
},
"category": {
"description": "Category label, e.g. 'work', 'mobile', 'home'.",
"type": "string"
}
},
"required": [
"number"
],
"description": "A phone-number entry."
}
},
"title": {
"description": "Job title.",
"type": "string"
},
"company_id": {
"description": "Id of the company this person works at.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"assignee_id": {
"description": "User id to own this person.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"tags": {
"description": "Replace the person's tags.",
"type": "array",
"items": {
"type": "string"
}
},
"details": {
"description": "Freeform description / notes.",
"type": "string"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴copper_create_company(name, email_domain, phone_numbers, assignee_id, tags, ...)
Create a new company. Copper REST: POST /companies.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The company name (required)."
},
"email_domain": {
"description": "The company's email domain, e.g. example.com.",
"type": "string"
},
"phone_numbers": {
"description": "Phone numbers for the company.",
"type": "array",
"items": {
"type": "object",
"properties": {
"number": {
"type": "string",
"description": "Phone number."
},
"category": {
"description": "Category label, e.g. 'work', 'mobile', 'home'.",
"type": "string"
}
},
"required": [
"number"
],
"description": "A phone-number entry."
}
},
"assignee_id": {
"description": "User id to own this company.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"tags": {
"description": "Tags to apply.",
"type": "array",
"items": {
"type": "string"
}
},
"details": {
"description": "Freeform description / notes.",
"type": "string"
}
},
"required": [
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴copper_create_opportunity(name, primary_contact_id, pipeline_id, pipeline_stage_id, company_id, ...)
Create a new opportunity (deal). `name` and `primary_contact_id` are required by Copper. Copper REST: POST /opportunities.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The opportunity name (required)."
},
"primary_contact_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Id of the primary contact (person) for this opportunity (required by Copper)."
},
"pipeline_id": {
"description": "Id of the pipeline to place the opportunity in.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"pipeline_stage_id": {
"description": "Id of the pipeline stage.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"company_id": {
"description": "Id of the associated company.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"assignee_id": {
"description": "User id to own this opportunity.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"monetary_value": {
"description": "Deal value (in the account's currency).",
"type": "number"
},
"close_date": {
"description": "Expected close date, formatted MM/DD/YYYY.",
"type": "string"
},
"details": {
"description": "Freeform description / notes.",
"type": "string"
},
"tags": {
"description": "Tags to apply.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"primary_contact_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴copper_create_lead(name, email, phone_numbers, company_name, title, ...)
Create a new lead. Copper REST: POST /leads.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The lead's name (required)."
},
"email": {
"description": "The lead's email.",
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Email address."
},
"category": {
"description": "Category label, e.g. 'work' or 'home' (default 'work').",
"type": "string"
}
},
"required": [
"email"
]
},
"phone_numbers": {
"description": "Phone numbers for the lead.",
"type": "array",
"items": {
"type": "object",
"properties": {
"number": {
"type": "string",
"description": "Phone number."
},
"category": {
"description": "Category label, e.g. 'work', 'mobile', 'home'.",
"type": "string"
}
},
"required": [
"number"
],
"description": "A phone-number entry."
}
},
"company_name": {
"description": "Company name the lead is associated with.",
"type": "string"
},
"title": {
"description": "Job title.",
"type": "string"
},
"customer_source_id": {
"description": "Id of the customer source.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"assignee_id": {
"description": "User id to own this lead.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"monetary_value": {
"description": "Estimated value of the lead.",
"type": "number"
},
"tags": {
"description": "Tags to apply.",
"type": "array",
"items": {
"type": "string"
}
},
"details": {
"description": "Freeform description / notes.",
"type": "string"
}
},
"required": [
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴copper_create_task(name, related_resource_type, related_resource_id, assignee_id, due_date, ...)
Create a new task. Copper REST: POST /tasks.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The task name (required)."
},
"related_resource_type": {
"description": "Type of record to attach the task to (requires related_resource_id).",
"type": "string",
"enum": [
"lead",
"person",
"company",
"opportunity",
"project",
"task"
]
},
"related_resource_id": {
"description": "Id of the record to attach the task to (requires related_resource_type).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"assignee_id": {
"description": "User id to own this task.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"due_date": {
"description": "Due date as a Unix timestamp (seconds).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"reminder_date": {
"description": "Reminder date as a Unix timestamp (seconds).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"priority": {
"description": "Task priority.",
"type": "string",
"enum": [
"None",
"High"
]
},
"details": {
"description": "Freeform description / notes.",
"type": "string"
},
"tags": {
"description": "Tags to apply.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴copper_log_activity(parent_type, parent_id, activity_type_id, details, activity_date)
Log a user activity (e.g. a note or call) on a record. Get the activity_type_id from copper_list_activity_types. Copper REST: POST /activities.
입력 스키마
{
"type": "object",
"properties": {
"parent_type": {
"type": "string",
"enum": [
"lead",
"person",
"company",
"opportunity",
"project",
"task"
],
"description": "The kind of record to attach the activity to."
},
"parent_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The id of the record to attach the activity to."
},
"activity_type_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Id of a 'user' activity type (from copper_list_activity_types)."
},
"details": {
"type": "string",
"description": "The activity note / description text."
},
"activity_date": {
"description": "When the activity occurred, as a Unix timestamp (seconds). Defaults to now.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"parent_type",
"parent_id",
"activity_type_id",
"details"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거