Surface AI
Test and personalize your site's pages from Claude Code or Codex, and check results. Key required.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"surface": {
"url": "https://mcp.surface-ai.io/mcp/"
}
}
}원격 엔드포인트
https://mcp.surface-ai.io/mcp/streamable-http할 수 있는 일
도구 목록
도구 (11)
🟢surface_get(surface_id)
Full details for one surface, including its edge_url and dashboard_url. To open the surface in the dashboard, open dashboard_url.
입력 스키마
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
}
},
"required": [
"surface_id"
],
"additionalProperties": false
}🟢surface_list
List every surface in the caller's organization, with each one's id, name, page URL, status and live_state. Use surface_get for one surface's dashboard link.
입력 스키마
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢surface_results(surface_id)
How a surface's test is doing: per variant, its sessions, sessions that reached the goal, conversion rate (rate_per_session) and win_probability — the bandit's estimated chance that variant is best. termination.should_terminate is the bandit's own signal that the test has a clear winner. Also all-time traffic per event. Results are recomputed hourly; before the first run, variants is empty and note says why. For sessions per day, use surface_traffic. Link the user to dashboard_url for charts.
입력 스키마
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
}
},
"required": [
"surface_id"
],
"additionalProperties": false
}🟡surface_setup(name, page_url, description, fields, goals, ...)
The way to add a surface to a page, in one step: the content fields it swaps, the goals it optimizes, and the variants — with the integration bundle deployed. Returns the install guide for adding the snippet to that page. Ask the user to choose the fields, goals and variants first; the new_surface prompt walks through it. Prefer data-attribute selectors such as [data-surface-field="headline"], added to the page source. Variants go live as soon as the snippet is deployed. Counts toward the plan's surface limit; a name already used in the organization is rejected.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Unique within the organization."
},
"page_url": {
"type": "string",
"description": "The live URL of the page."
},
"description": {
"type": "string",
"description": "Optional note shown in the dashboard."
},
"fields": {
"type": "array",
"minItems": 1,
"description": "Page elements each variant replaces.",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]*$",
"description": "Lowercase identifier, e.g. headline, cta_label."
},
"selector": {
"type": "string",
"description": "CSS selector for the element."
},
"value_type": {
"type": "string",
"enum": [
"text",
"html",
"image",
"video",
"input_value"
],
"description": "text sets textContent, html innerHTML, image/video src, input_value an input's value."
},
"description": {
"type": "string",
"description": "What the field is, e.g. Hero headline."
}
},
"required": [
"key",
"selector",
"value_type"
],
"additionalProperties": false
}
},
"goals": {
"type": "array",
"minItems": 1,
"description": "What success looks like; the first is the one the bandit optimizes.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "e.g. Book a demo."
},
"selector": {
"type": "string",
"description": "The button, link or form. For an element that is also a field, that field's exact selector — one click is then one event, not two."
},
"dom_event": {
"type": "string",
"enum": [
"click",
"submit"
],
"description": "click for a button or link, submit for a form."
}
},
"required": [
"name",
"selector",
"dom_event"
],
"additionalProperties": false
}
},
"variants": {
"type": "array",
"minItems": 2,
"description": "Exactly one is the control: the page's current copy, setting every field.",
"items": {
"type": "object",
"properties": {
"contents": {
"type": "object",
"description": "Field key to value."
},
"is_control": {
"type": "boolean",
"description": "True for the control only."
}
},
"required": [
"contents"
],
"additionalProperties": false
}
}
},
"required": [
"name",
"page_url",
"fields",
"goals",
"variants"
],
"additionalProperties": false
}🟢surface_traffic(surface_id, start_date, end_date)
Sessions per day for a surface, as {date, sessions}. With no dates, every recorded day. For conversion and winners, use surface_results.
입력 스키마
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"start_date": {
"type": "string",
"description": "First day, YYYY-MM-DD."
},
"end_date": {
"type": "string",
"description": "Last day, YYYY-MM-DD."
}
},
"required": [
"surface_id"
],
"additionalProperties": false
}🔴surface_update(surface_id, name, description, status, page_url, ...)
Change a surface's name, description, status, page URL or location; fields you leave out are unchanged. Returns the updated surface. ARCHIVED stops it serving; making it ACTIVE again counts toward the plan's surface limit. To change content, use the variant_ tools; to add a surface, surface_setup.
입력 스키마
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"name": {
"type": "string",
"description": "Unique within the organization."
},
"description": {
"type": "string",
"description": "Note shown in the dashboard."
},
"status": {
"type": "string",
"enum": [
"ACTIVE",
"ARCHIVED"
],
"description": "ACTIVE serves variants; ARCHIVED stops serving."
},
"page_url": {
"type": "string",
"description": "The live URL of the page."
},
"location": {
"type": "string",
"enum": [
"WORLDWIDE",
"UNITED_STATES",
"EUROPE",
"ASIA_PACIFIC"
],
"description": "Serving region."
}
},
"required": [
"surface_id"
],
"additionalProperties": false
}🟡variant_create(surface_id, variants)
Add variants to a surface, as DRAFT; activate them with variant_set_status. Returns the surface's full variant list.
입력 스키마
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"variants": {
"type": "array",
"minItems": 1,
"items": {
"type": "object"
},
"description": "Each an object of field key to value, with the keys the surface's fields use. Optional is_control (one per segment) and segment_id."
}
},
"required": [
"surface_id",
"variants"
],
"additionalProperties": false
}🟢variant_list(surface_id)
List every variant of a surface, the control included: each one's id, status, is_control and raw_contents (a JSON object of field key to value).
입력 스키마
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
}
},
"required": [
"surface_id"
],
"additionalProperties": false
}🔴variant_set_control(surface_id, variant_id)
Make a variant the control of its segment — the baseline the others are measured against — replacing the current control. An archived variant can't be the control. Status is unchanged; use variant_set_status for that.
입력 스키마
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"variant_id": {
"type": "integer",
"description": "The variant id, from variant_list."
}
},
"required": [
"surface_id",
"variant_id"
],
"additionalProperties": false
}🔴variant_set_status(surface_id, variant_id, status)
Activate, pause or archive a variant. Only active variants are served. To change which variant is the control, use variant_set_control.
입력 스키마
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"variant_id": {
"type": "integer",
"description": "The variant id, from variant_list."
},
"status": {
"type": "string",
"enum": [
"ACTIVE",
"PAUSED",
"ARCHIVED"
],
"description": "ACTIVE serves it; PAUSED and ARCHIVED stop serving it."
}
},
"required": [
"surface_id",
"variant_id",
"status"
],
"additionalProperties": false
}🔴variant_update(surface_id, variant_id, contents)
Replace a draft variant's contents with the given object. Only drafts can be edited; to change a live variant, create a new one and archive the old.
입력 스키마
{
"type": "object",
"properties": {
"surface_id": {
"type": "integer",
"description": "The surface id, from surface_list."
},
"variant_id": {
"type": "integer",
"description": "The variant id, from variant_list."
},
"contents": {
"type": "object",
"description": "The new contents, in the shape variant_create takes."
}
},
"required": [
"surface_id",
"variant_id",
"contents"
],
"additionalProperties": false
}커뮤니티
증거