Surface AI

Test and personalize your site's pages from Claude Code or Codex, and check results. Key required.

사용해야 할까요

품질 및 안전성

A
설명 품질
98%
스키마 완전성
94%
이름 품질
80%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,019토큰 (도구 정의)
~1.3 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.58%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 11개