@prismism/mcp-server

Prismism을 위한 MCP 서버 — AI 에이전트를 위한 DocSend.

파일을 업로드하고 추적 가능한 공유 링크를 받으세요. PDF, HTML, Markdown, 이미지, 비디오를 지원합니다. 접근 제어, 분석, 이메일 수집, 웹훅 기능을 제공합니다.

빠른 시작

1. API 키 받기

prismism.dev에서 무료 계정을 생성하거나 설정 후 prismism_register 도구를 사용하세요.

2. 클라이언트 연결

호스팅 엔드포인트 (권장)

설치가 필요 없습니다 — Prismism API에 직접 연결하세요:

Claude Code

claude mcp add prismism --transport http https://prismism.dev/mcp \
  --header "x-api-key: pal_your_key_here"

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json 파일을 수정하세요:

{
  "mcpServers": {
    "prismism": {
      "url": "https://prismism.dev/mcp",
      "headers": {
        "x-api-key": "pal_your_key_here"
      }
    }
  }
}

Cursor — .cursor/mcp.json 파일을 수정하세요:

{
  "mcpServers": {
    "prismism": {
      "url": "https://prismism.dev/mcp",
      "headers": {
        "x-api-key": "pal_your_key_here"
      }
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json 파일을 수정하세요:

{
  "mcpServers": {
    "prismism": {
      "serverUrl": "https://prismism.dev/mcp",
      "headers": {
        "x-api-key": "pal_your_key_here"
      }
    }
  }
}

VS Code — .vscode/mcp.json 파일을 수정하세요:

{
  "servers": {
    "prismism": {
      "type": "http",
      "url": "https://prismism.dev/mcp",
      "headers": {
        "x-api-key": "pal_your_key_here"
      }
    }
  }
}

로컬 (stdio) — 대안

로컬 전송 방식을 선호한다면 npx를 통해 실행하세요:

{
  "mcpServers": {
    "prismism": {
      "command": "npx",
      "args": ["@prismism/mcp-server"],
      "env": {
        "PRISMISM_API_KEY": "pal_your_key_here"
      }
    }
  }
}

3. 작동 확인

에이전트에게 다음과 같이 물어보세요: "Use the prismism_health tool to check the connection"

도구

게시하기

"Publish this report as a shareable link"

prismism_publish 도구는 세 가지 모드를 지원합니다:

• 파일 업로드 — content(일반 텍스트 또는 base64) + filename을 설정하세요. 바이너리 파일의 경우 encoding: "base64"를 사용하세요.

• 인라인 HTML — 원본 HTML 콘텐츠와 함께 html을 설정하세요. 파일이 필요 없습니다.

• 인라인 Markdown — 원본 Markdown 콘텐츠와 함께 markdown을 설정하세요. 파일이 필요 없습니다.

모든 모드는 선택적으로 access, password, requireEmail, allowedDomains, allowedEmails, expiresAt, allowNetwork 매개변수를 지원합니다.

지원되는 파일 형식: PDF, HTML, Markdown, 이미지(PNG/JPG/GIF/SVG/WebP), 비디오(MP4).

콘텐츠 가져오기

"Get the content of my artifact abc123"

prismism_content 도구는 원본 아티팩트 콘텐츠를 가져옵니다. 텍스트 형식은 UTF-8 문자열로 반환되며, 바이너리 형식은 base64로 반환됩니다. 소유자의 API 키는 모든 게이트를 자동으로 우회합니다. 소유자가 아닌 경우 게이트가 설정된 콘텐츠에 접근하려면 password 또는 email 매개변수를 전달하세요.

접근 제어

"Make this artifact private"
"Set allowlist access with alice@acme.com"

prismism_update 도구는 access(public/private/allowlist), allowedEmails, password, requireEmail, allowedDomains를 지원합니다. private/allowlist로 변경하면 기존의 비밀번호 및 이메일 게이트는 자동으로 해제됩니다.

키 없이 등록하기

아직 API 키가 없다면 prismism_register 도구를 사용하여 계정을 생성할 수 있습니다:

"Register me on Prismism with my email"

이 도구는 API 키를 한 번 반환하며, 에이전트가 이를 설정 파일에 저장하도록 도와줄 것입니다.

환경 변수

응답 형식

모든 도구는 일관된 JSON 봉투(envelope)를 반환합니다:

{
  "ok": true,
  "data": { ... },
  "_hints": ["Actionable guidance for the agent"]
}

오류 발생 시:

{
  "ok": false,
  "error": { "code": "STORAGE_LIMIT", "message": "..." },
  "_hints": ["Upgrade at https://prismism.dev/settings/billing"]
}

요구 사항

• 호스팅 엔드포인트: 요구 사항 없음 — 모든 MCP 클라이언트와 호환

• 로컬 (stdio): Node.js 18+, npm 또는 npx

라이선스

MIT

링크

• Prismism — 모든 파일을 위한 공유 링크

• API 문서

• OpenAPI 사양